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SECTION 1.0 

INTRODUCTION TO RAE 

1.0 INTRODUCTION 

This 6502 resident relocating macro assembler and text editor reside 
simultaneously in 8K bytes of ROM memory. Sufficient memory must be provided for 
a Source (text) file and Label file (symbol table) . Approximately 2K is 
sufficient memory for the source file for small programs or larger programs if 
assembled from tape. A good rule of thumb is one byte of memory for the label 
file for each byte of object code. If an executable object code file is to be 
stored in memory during assembly, sufficient memory must be provided for it 
also. On cold start entry, the RAE will set the file boundaries as follows: 

* Source file = 0200-OBFC 1000-7FFC in GoertzWorks! Ram Model 

* Object file = Not Specified 0200-0FFF in GoertsWorks! Ram Model 

* Label file = 0C00-0EFC D000-DFFC in GoertzWorks! Ram Model 

* Relocatable object buffer = OFOO N/A in GoertzWorks! Ram Model 

The label file and text file that RAE generates are position independent and may 
be located practically anywhere in RAM memory. The object code file location is 
dependent on the beginning of assembly (.BA) and the move code (-MC) pseudo ops. 

RAE was designed such that records in the label file and text file are variable 
in length and directly dependent on the number of characters to be stored. This 
results in efficient utilization of memory. 

Some major features of RAE are: 

* Macro and conditional assembly support. 

* Labels up to 10 characters in length. 

* Auto line numbering for ease of text entry. 

* Creates either executable code in memory or relocatable object code on 
tape. 

* Manuscript feature for composing letters and other text. 

* Loading and storing of text on tape. 

* Supports up to two tape decks, terminal with keyboard, and printer. 

* String search and replace capability, plus other powerful editing 
commands . 

* Upper and lower case accepted. 

Throughout this document, output generated by RAE is underlined if necessary to 
distinguish it from user input. 



Initial entry (cold start) to RAE is at address B000. Warm start is at address 
B003. If the break command (>BR) is executed, one may return to the address 
following the break. Initial entry provides the following default parameters: 

FOR TED 

* Format - set 

* Manuscript - clear 

* Auto line numbering - or clear 

* Text file - clear 

* Tape units - off 

* Hardcopy - clear 

FOR ASSEMBLER 

* Assumes assembling from memory (otherwise use . CT) . 

* Does not store object code in memory (otherwise use .OS) . 

* Begins assembly at $0200 (otherwise use .BA) . 

* Output listing clear (otherwise use .LS or >ASSEMBLE LIST). 

* Stops assembly on errors (otherwise use .CE) . 

* Stores object code beginning at $0200 unless a .BA or .MC is encountered 
and if .OS is present. 

* Generates relocatable addresses. 

* Macro object code is not output (otherwise use .ES) . 

The RAE is designed to operate with a cassette record unit and a play unit. A 
single record/play unit may be used but one will not be able to create 
relocatable object files when assembling from tape. 

When inputting to RAE the following control codes are useful: 

CONTROL H (hex 08) 

Rubout or Delete (hex 7F) Backspaces over previous character. More 

than one of these may be entered to delete a 
number of characters. A backslash is echoed 
if rubout is depressed. 

CONTROL X (hex 18) Deletes the entire line. 

Break Key Halts outputting, and waits for input of 

appropriate control code. 

For a more detailed list see Section 8. 



SECTION 2.0 

GETTING STARTED WITH RAE 

2.1 GENERAL 

An assembler is a program which allows the user to compose and enter programs at 
the machine language level in a form that is much more convenient than actual 
machine code. The assembler accepts mnemonic names for individual instructions, 
allows symbolic names to be assigned to memory locations and data, provides for 
address arithmetic in terms of symbolic names, and certain other features, 
depending on the sophistication of the assembler in question. 

The Synertek System's Resident Assembler/Editor (RAE) is a full features 
assembler. Other major features include: macros with nesting capability, 
conditional assembly, creation of relocatable object code supported by a 
relocating loader, string search/replace and line editing, automatic control of 
two I/O tape units, and assemble directly from tape. 

It is commonly thought that the primary feature offered by an assembler is that 
of writing machine instructions in a more convenient form. However, this is only 
one aspect of the advantage of an assembler, and perhaps not even the most 
significant. The use of symbolic names to represent numbers makes variables of 
what most likely would have been considered constants. The very presence of 
symbols bestows a generality and flexibility to a program which otherwise might 
have seemed quite rigid. This encourages the programmer to abstract the 
immediate problem and perhaps develop a more adaptable program. Also, since the 
actual calculation or assignment of a value to a symbol can be deferred, the 
development of logically separate modules can proceed freely. Programs so 
organized become much more readable and manageable, both in their maintenance 
and amenability to revision. 

The purpose of an assembler is to translate a program written in assembly 
language into machine language. Machine language refers to that representation 
of instructions which are immediately interpretable by the machine being 
considered. For all intents and purposes, the machine language of the 6502 
consists of hexadecimal opcodes and data. An assembly language is a symbolic 
representation of machine language instructions; e.g., LDA # is used to 
represent the instruction A9, LoaD the Accumulator with the value following the 
# sign (immediate) . 

The program written in assembly language is called the source code, the machine 
language program produced by the assembler is called the object code. 

With or without an assembler, it should be realized that programs are usually 
written in assembly language. The assembler simply saves us the tedious and 
error-prone task of translating our program into machine code. 

The assembler accomplishes the conversion of the source code to machine code in 
two passes; that is, the source program is scanned twice. During the first pass 
all symbols and their associated values are collected into a label file (also 
called a symbol table) . During the second pass the assembler converts the 
program to machine language (also called object code) , using the definitions 
collected in the first pass. 

One important feature that all assemblers share is that of assembler directives, 
or pseudo ops. These are special orders to the assembler itself about the way it 



is to deal with the source program, or for the definition and manipulation of 
symbols and allocation <of storage. The distinction between operations (machine 
instructions) and pseudo operations is similar to that between a manuscript to 
be typed and the author's marginal notes to the typist. For example, directives 
are used to tell the assembler to set aside 100 memory locations to be used for 
an array, or to tell it where the object code is to be stored in memory. 

2.2 HARDWARE PREPARATION 

2.2.1 RAE ROM ADDRESSING 

Your RAE is contained in one (RAE-1) or two (RAE-1/2) ROMs. These ROMs are 
designed to run under the SYM-1 SUPERMON monitor or the MDT-1000 system 
monitor. 

Before you install the ROMs into your system, refer to your system 
"reference manual to locate ' or "strap" the desired ROM socket at the 
correct memory address as shown below. 

RAE-1 RAE-1/2 

Two 4K byte chips (2332 ' s) 
P/N's 02-0023A and 02-0024A 
Chip select pin 20 
Address: 2 Prom's 
BOOO-BFFF (02-0023A) 
EOOO-EFFF (02-0024A) 

For detailed discussion of jumper configurations for SYM-1, see Section 
10.0, paragraph 4. 

2.2.2 AUDIO CASSETTE I/O 

RAE is designed to work with a dual audio cassette system using Synertek 
Systems' high speed recording format. Cassette unit #0 is designated the 
record unit and unit #1 is designated the play unit. A single cassette 
player may be used for most operations except where the user wishes to 
assemble source from tape and store object code back onto tape. 

Refer to your particular system's reference manual for details on I/O 
addressing, remote control, and adjustments. The following is a summary of 
each of these: 

ADDRESSING (IN, OUT, REMOTE CONTROL) 



• 


Single 8K byte chip (2364) 


* 


* 


P/N 02-0053A 


* 


* 


Chip select pin 20 


* 


* 


Address: 1 Prom 

BOOO-BFFF 

EOOO-EFFF 


* 











REMOTE 


REMOTE 










CONTROL 


CONTROL 










# o 


# 1 


SYSTEM 


AUDIO IN 




AUDIO OUT 

A4 00 (SYM 


RECORD 

A00C-CB2 


PLAY 


SYM-1 


A000-BIT 


6 


A000-BIT 7 








ref. manual) 






MDTI000 


9600-BIT 


7 


9600-BIT 6 


9703-CB2 


9701-CA2 



TOHE 
VOLUME* 

TAPE 



AUDIO CASSETTE RECORDER ADJUSTMENTS 

High or treble. 

2V peak-to-peak or saturation (max volume) from recorder 
(suggested for most recorders) . 

Data tape or high quality, low noise audio tape. Short lengths 
(30 mm or less) works best 



SUGGESTED 
RECORDER 



Sanyo M2544A or equivalent 



* Each recorder type will require a volume adjustment in order to obtain 
maximum reliability, 2vp-p or saturation (max volume) works well on most 
recorders . 

2.3 STEP-BY-STEP EXAMPLE 

To access the Resident Assembler/Editor (RAE) , power up your system and log-on 
to your terminal, then type "G B000"; this is the cold start entry point. (The 
warm start entry point is B003) . 

RAE will respond with: 

RAE VI .0 

COPYRIGHT 1979 SYNERTEK SYSTEMS CORP. 

0200-OBFC 0C00-0EFC 0F00 
0200 0C00 

NOTE: TEXT FILE 0200-OBFC 
LABEL FILE 0C00-0EFC 
RELOCATABLE OBJECT BUFFER 0F00 
CURRENT END OF TEXT BUFFER 0200 
CURRENT END OF LABEL BUFFER 0C00 

If you inadvertently stop RAE' s log-on printout before the first prompt 
character (>) is displayed, RAE will double echo each character typed and also 
ignore any commands. To exit this mode, type CONTROL O 

The ">" is the prompt symbol from RAE, indicating it is ready to accept 
commands. In the following procedures the ">" is not shown. Only the most 
commonly used commands and the major features of RAE will be discussed in the 
following section. Several examples will be used to illustrate their use and 
action. 

NOTE 



ALL COMMANDS MUST BE ENDED WITH A CARRIAGE 
RETURN. If you make a typing error, enter a 
CONTROL H or a RUBOUT to delete the last 
character. Several CONTROL H's can be 
entered to remove more than one character. A 
CONTROL X will eliminate the entire line. 
Processing can be suspended by pressing the 
BREAK key and resumed with a CONTROL Q. 



We will begin by entering a program segment which fills page 3 (0300-03FF) of 

memory with zeros. Each, line of text must be preceded by a line number, so that 

RAE can order them properly, as well as process any changes we may wish to make 
as we go along. 

Type in the following lines exactly as they appear, immediately following the 
prompt symbol: 

10 LDX #0 

20 TXA 

30LOOP STA $300, X 

40 DEX 

50 BNE LOOP 

Note that the instruction mnemonics and addressing mode formats are those 
defined and described in the SY 6500 Programming Manual (MNA-2) . 

Now type in: 
PRINT 

RAE will respond with: 



0010 




LDX #0 


0020 




TXA 


0030 


LOOP 


STA $300, X 


0040 




DEX 


0050 




BNE LOOP 


// 







Notice that RAE automatically lines up the label, instruction, and operand 
fields, and that if the first character is a blank the label field is skipped. 
To examine lines 20 through 40 only, type in: 

PRINT 20 40 

RAE will reply with: 

0020 TXA 

0030 LOOP STA $300, X 

0040 DEX 

// 

Notice that the line numbers in the PRINT command are separated by blanks, not 
commas. This is the convention used by RAE in specifying all command parameters. 
Let us now try to assemble our program. Type in: 

ASSEMBLE LIST 

RAE will print: 

0050 BNE LOOP 

!07 AT LINE 0050/44 

This is an error message, telling us that the .EN (end of program) pseudo op is 
missing. It is required to indicate to RAE the end of the source program. Let us 
put it in and try again. 



Type in the following: . ' 

60 .EN 
ASSEMBLE LIST 

RAE will respond with: 

0200- A2 00 0010 LDX #0 

0202- BA 0020 TXA 

0203- 9D 00 03 0030 LOOP STA $300, X 

0206- CA 0040 DEX 

0207- DO FA 0050 BNE LOOP 

0060 .EN 

LABEL FILE: [ / = EXTERNAL ] 

LOOP=0203 
//0000 0209,0209 

This time assembly of our program was successful. The listing produced shows us 
the object code as well as the source code. The leftmost column contains the 
address of the first byte of each instruction. As can be seen, the default 
beginning address is $200. The .BA (Begin Assembly) pseudo op is used when we 
wish RAE to assemble beginning at some other address, say $500. 

Type in: 

5 .BA $500 
ASSEMBLE LIST 

RAE will respond with: 

0005 .BA $500 

0500- A2 00 0010 LDX #0 

0502- 8A 0020 TXA 

0503- 9D 00 03 0030 LOOP STA $300, X 

0506- CA 0040 DEX 

0507- DO FA 0050 BNE LOOP 

0060 .EN 

LABEL FILE: [ / = EXTERNAL ] 

LOOP=0503 
//0000, 0509, 0509 

Up to this point everything RAE has done has been "on paper". If we want the 

object code generated by RAE to be actually stored in memory at the address 

specified, we need to include the .OS (object store) pseudo op. Type in the 
following: 

6 .OS 
ASSEMBLE 

Notice that the LIST option was omitted from the ASSEMBLE command. This time RAE 
will simply print: 

//0000,0509,0509 



Let us exit RAE momentarily to examine some .memory locations. To exit to the 
system monitor type: 

BREAK (or CONTROL C) 

The system monitor will print: 
B0AC,0 

Now type: 

V 0500 

The system monitor will reply: 

0500 A2 00 8A 9D 00 03 CA DO, 66 
0366 

This is the object code of our program, stored by RAE. To continue where we left 
off type either: 

G B003 or 6 

B003 is the warm start entry point to RAE. If the cold entry point were used our 
text file would be lost. 

RAE will print: 

0200-OBFC 0C00-0EFC 0F00 
0246 0C06 

In order to execute our program without exiting RAE, we need to make the last 
executable instruction an RTS so that control will be returned to RAE. 

Type in: 

55 RTS 
ASSEMBLE 

RAE will print: 

//0000,050A,050A 
Now enter: 

RUN $500 

RAE will come back with the prompt sign, ">". Let us exit RAE again to verify 
that the program ran. 

Type: 

BREAK 



I. 



System monitor will print: _.. . - ' 

B0AC,0 

Now type : 

V 0300 

System monitor will print: 

0300 00 00 00 00 00 00 00 00,00 
0000 

Apparently our program worked as intended. Get back into RAE. Recall that the 
warm entry point is B003. 

Let us begin a new example. This time we will change the starting boundary of 
the text file to allow room for object code to be stored in memory at the RAE 
default origin. Type the following: 

SET $300 

RAE will respond with: 

0300-OBFC 0C00-0EFC 0P00 
024E 0C06 

We must now clear the text file because its starting boundary has been changed. 
Failure to do so is catastrophic. To do this type: 

CLEAR 

If you now type PRINT, RAE will simply print //, which is the end-of-text 
indicator. The following code is for a pseudo-random number generator. To make 
the entering of the text easier, first type in: 

AUTO 10 

This command enables the automatic line numbering option. The 10 will be used as 
the line number increment. AUTO goes into effect after a line is referenced. 

Type in: 

100RND SEC 

RAE will now respond with: 

0110> 

which is the next line number. Now enter the following lines after each line 
number, remembering to leave a space if there is no label: 

LDA TABLE+1 
ADC TABLE+4 
ADC TABLE+5 



STA TABLE 
LDX #4 
MOVE IDA TABLE, X 
STA TABLE+1,X 
DEX 

BPL MOVE 
RTS 

To exit AUTO, type: 

// 
We must be sure to include the .EN (end of program) pseudo op, so enter: 

999 .EN 
RAE will respond with: 

1009> 

This is because the AUTO mode is still enabled. Type // to exit AUTO, then, to 
turn off the AUTO option, type: 

AUTO 

Let's now try to assemble our code. Enter: 
ASSEMBLE LIST 



RAE will reply 
0200- 38 



0100 RND 
0110 
!08 AT LINE 0110/00 



SEC 

LDA TABLE+1 



This error message tells us that there is an undefined label in line 110. The 
problem is, of course, that RAE has no way of knowing what the symbol TABLE 
represents. TABLE is meant to be the name of an array of six elements. The 
pseudo op .DS (Define Storage) is used to tell RAE to set aside a specified 
number of memory locations. 



Type in: 



90TABLE .DS 6 
ASSEMBLE LIST 



RAE will print: 



0200- 








0090 


TABLE 


.DS 6 


0206- 


38 






0100 


RND 


SEC 


0207- 


AD 


01 


02 


0110 




LDA TABLE+1 


020A- 


6D 


04 


02 


0120 




ADC TABLE+4 


020D- 


6D 


05 


02 


0130 




ADC TABLE+5 


0210- 


8D 


00 


02 


0140 




STA TABLE 


0213- 


A2 


04 




0150 




LDX #4 


0215- 


BD 


00 


02 


0160 


MOVE 


LDA TABLE, X 


0218- 


9D 


01 


02 


0170 




STA TABLE+1, X 



021B- 


CA 


0180 


021C- 


10 F7 


0190 


021E- 


60 


0200 
0999 



DEX 

BPL MOVE 

RTS 

.EN 



LABEL FILE: [ / = EXTERNAL ] 
TABLE-0200 RND=0206 

//0000,021F,021F 



MOVE=0215 



Notice that TABLE has been assigned the address 200 (hex) , and that the first 
byte of code is at location 206. Thus locations 200 - 205 have been reserved; 
TABLE+1 is memory location 201, TABLE+2 is 202, etc. 

To test this routine we will add some code which will call RND as a subroutine 
and print out the pseudo random numbers generated. To aid us in the output we 
will call on two subroutines in the system monitor: OUTBYT and CRLF. OUTBYT 
outputs the contents of the accumulator as two hex digits, and CRLF outputs a 
carriage return and a line feed. 

In order to use them, we must tell RAE where they are located. This is done 
using the -DE (Define External) pseudo op, which tells RAE that the addresses 
specified are external to our program. Type in the following lines: 

40 .OS 

500OUTBYT .DE $82FA 

60CRLF .DE $834D 

300START LDY #8 

310NEXT JSR RND 

320 LDA TABLE 

330 JSR OUTBYT 

340 JSR CRLF 

350 DEY 

360 BNE NEXT 

370 RTS 



Assemble, and check that your output looks exactly as follows: 











0040 




.OS 












0050 


OUTBYT 


.DE 


$82FA 










0060 


CRLF 


.DE 


$834D 


0200- 








0090 


TABLE 


.DS 


6 


0206- 


38 






0100 


RND 


SEC 




0207- 


AD 


01 


02 


0110 




LDA 


TABLE+1 


020A- 


6D 


04 


02 


0120 




ADC 


TABLE+4 


020D- 


6D 


05 


02 


0130 




ADC 


TABLE -t-5 


0210- 


BD 


00 


02 


0140 




STA 


TABLE 


0213- 


A2 


04 




0150 




LDX 


#4 


0215- 


BD 


00 


02 


0160 


MOVE 


LDA 


TABLE, X 


0218- 


9D 


01 


02 


0170 




STA 


TABLE+1, X 


021B- 


CA 






0180 




DEX 




021C- 


10 


F7 




0190 




BPL 


MOVE 


021E- 


60 






0200 




RTS 




021F- 


A0 


08 




0300 


START 


LDY 


#8 


0221- 


20 


06 


02 


0310 


NEXT 


JSR 


RND 


0224- 


AD 


00 


02 


0320 




LDA 


TABLE 



0227- 20 FA 


82 


0330 


JSR OUTBYT 


022A- 20 4D 


63 


0340 


JSR CRLF 


022D- 88 




0350 


DEY 


022E- DO Fl 




0360 


BNE NEXT 


0230- 60 




0370 


RTS 






0999 


.EN 


LABEL FILE: 


[ 


/ = EXTERNAL ] 




/OUTBYT=82FA 


/CRLF=834D 


TABLE=0200 


RND=0206 




MOVE=0215 


START=021F 


NEXT=0221 









//0000,0231 ,0231 

Since the .OS (Object Store) pseudo op was present, the object code was stored 
in memory, so we can now run the program. Type in: 

RUN START 

The output you get will depend on what values happened to be in memory at 
locations 200-205. With 20 (hex) in each location, the output will be: 

61 
A2 
E3 
25 
A7 
AC 
33 
3C 

It is common practice to- place all subroutines after the main body of the 
program. Thus, in the above example, we would like to place lines 100 through 
200 after line 370. The MOVE command allows this to be done very easily. 

Type in: 

MOVE 370 100 200 

To see what has been done, enter: 
PRINT 360 999 

RAE will print: 



0360 




BNE NEXT 


0370 




RTS 


0370 


RND 


SEC 


0370 




LDA TABLE+1 


0370 




ADC TABLE+4 


0370 




ADC TABLE+5 


0370 




STA TABLE 


0370 




LDX #4 


0370 


MOVE 


LDA TABLE, X 


0370 




STA TABLE+1, X 


0370 




DEX 



0370 BPL MOVE 

0370 RTS 

0999 .EN 

If you type PRINT 100 200 you will see that lines 100 through 200 no longer 
exist. Since all the moved lines have been given the same number, we would like 
to renumber the text file. That is the purpose of the NUMBER command. 

Type in: 

NUMBER 90 10 

The 90 specifies the line to begin the renumbering, and the 10 specifies the 
increment to use. If you now PRINT out the entire file you will see that each 
line number is again unique. 

NOTE 

The following example will utilize the audio cassette 
storage unit. If your cassette unit is not connected 
or adjusted refer to your system reference manual. 

The next example is a routine which multiplies the contents of memory location 
MLTPLR times the contents of location MLTPND. The product will be two bytes 
long; the high part will be in the accumulator and the low part in location 
RESLO. OUTBYT will again be used to output the result. Type in: 

CLEAR 
AUTO 10 
100MULT LDA #0 

RAE will respond with: 
0110> 

Now enter the following lines after each line number: 

STA RESLO 

LDX #8 
LOOP LSR MLTPLR 

BCC NOADD 

CLC 

ADC MLTPND 
NOADD LSR A 

ROR RESLO 

DEX 

BNE LOOP 
;LINE 210 

JSR OUTBYT 

LDA RESLO 

JSR OUTBYT 

RTS 

.EN 

// 
AUTO 



Line 210 is a comment line. A comment line begins with a semicolon and may 
contain any characters after that, as comment lines are ignored by RAE. In this 
case, it is used to separate the multiplication routine from the output section 
for better readability^ Comments may also appear on any text line by simply 
separating the text and comment by at least one space. As an example, retype 
lines 100 and 110 as follows: 

100MOLT IDA #0 ZERO RESULT HI 
110 STA RESLO ZERO RESULT LOW 

Before this routine will assemble we need to define the symbols OUTBYT, RESLO, 
MLTPLR and MLTPND. Type in: 

40OUTBYT .DE $82FA 
50RESLO .DS 1 
60MLTPLR .BY 2 
70MLTPND .BY 3 

The .BY (store bytes of data) pseudo op directs RAE to store the following value 
in the next memory location. MLTPLR and MLTPND will thus contain the numbers 2 
and 3, respectively. 

Finally, we need to add the .OS (object store) pseudo op, and let us also put in 
the .LS (print source listing on pass 2) pseudo op which enables the list option 
on assembly. Enter: 



10 .OS 
20 .LS 
ASSEMBLE 



i 



RAE will print: 











0010 


.OS 














0020 


.LS 














0040 


OUTBYT 


.DE 


$82FA 


0200- 








0050 


RESLO 


.DS 


1 


0201- 


02 






0060 


MLTFLR 


.BY 


2 


0202- 


03 






0070 


MLTPND 


.BY 


3 


0203- 


A9 


00 




0100 


MULT 


LDA 


#0 ZERO RESULT HI 


0205- 


BD 


00 


02 


0110 




STA 


RESLO ZERO RESULT LOW 


0208- 


A2 


08 




0120 




LDX 


#8 


020A- 


4E 


01 


02 


0130 


LOOP 


LSR 


MLTPLR 


020D- 


90 


04 




0140 




BCC 


NOADD 


020F- 


18 






0150 




CLC 




0210- 


6D 


02 




0160 




ADC 


MLTPND 


0213- 


4A 






0170 


NOADD 


LSR 


A 


0214- 


6E 


00 


02 


0180 




ROR 


RESLO 


0217- 


CA 






0190 




DEX 




0218- 


DO 


F0 




0200 
0210 


;LINE 210 


BNE 


LOOP 


021A- 


20 


FA 


82 


0220 




JSR 


OUTBYT 


0210- 


AD 


00 


02 


0230 




LDA 


RESLO 


0220- 


20 


FA 


82 


0240 




JSR 


OUTBYT 


0223- 


60 






0250 
0260 




RTS 
.EN 





LABEL FILE: [ / = EXTERNAL ] 

/OUTBYT=82FA RESLO=0200 MLTPLR=0201 

MLTFND=0202 MOLT=0203 LOOP=020A 

NOADD=0213 
//OOOO, 0224, 0224 

If your output looks exactly as the above, the program is ready to be run. 

Type in: 

RUN MOLT 
The output will be: 

0006 

Now change the values in lines 60 and 70, assemble the new program and run it. 
For example the product of 4 and 9 is 0024 (hex), and that of 45 and 68 is 0BF4 
(hex) . 

One of the most important and fundamental features of RAE is the ability to read 
and write to the cassette unit. We will save on tape and then retrieve the 
current program. Place a blank tape in your recorder, advance tape beyond blank 
leader and put the recorder in record mode. 

Now type: 

PUT Fl 

After the file has been recorded RAE will return with the prompt. Repeat this 
procedure twice more to ensure a good recording. We will now read in the text 
file just recorded. Rewind the tape. 

Now put the tape unit in the play mode, and type in: 

GET Fl 
When the file has been read in successfully, RAE will print: 

F01 011F 0200-031F 

If you now type PRINT, you can verify that the file was read in correctly. If an 
error occurs, retype GET Fl and start the tape again. 

Now that you are acquainted with the basic features offered by RAE, you are 
encouraged to read Sections 3 and 4 in order to become familiar with the many 
other commands, pseudo ops, and editing features available to you. By far the 
most effective, efficient and enjoyable way to do this is to construct examples 
to try out each feature. Learning by doing will show you exactly how each 
feature works, and will enable you to utilize the full potential of the Synertek 
System's Resident Assembler/Editor. 



SECTION 3;0 
TEXT EDITOR (TED) 



3.1 TEXT EDITOR COMMANDS 

The TED provides 27 command functions. When entered, a command is not executed 
until a carriage return is given. Although a command mnemonic such as >PR may be 
several non-space characters in length, the ASM/TED considers only the first 
two. For example, >PR, >PRI, >PRINT, and >PRETTY will be interpreted as the 
print command. 

Some commands can be entered with various parameters. For example, >PRINT 10 200 
will print out the text in the text file with line numbers between 10 and 200. 
One must separate the mnemonic and the parameters from one another by at least 
one "space. Do not use commas. "For alphabetic parameters, only the first 
character is considered. For example "FORMAT CLEAR" is the same as "FO C." 



NAME 



>ASSEMBLE w x 



EXAMPLE 

>AS LI 
>AS N 
>AS L 200 



>AUTO x 



>AU 10 
>AU 
>AUTO 20 



>BREAK 



>BR 
>BRK 



>CLEAR 



>COPY x y z 



>CL 



>CO 110 10 40 
>CO 300 100 200 



PURPOSE/USE 

Clear the label file and then assemble 
source in the text file starting at 
line number x or if x is not 
entered. If w = LIST then a listing 
will be generated. If w = NOLIST 
or not entered then an errors only 
output will be generated. 

Automatic line numbering occurs 
when an x value not equal to zero 
is entered, x specifies the increment 
to be added to each line number. 
Auto line numbering starts after 
entering the first line. To prevent 
auto line numbering from reoccurring 
enter >AU or >AU 0, after first 
exiting with //. 

Break to system monitor (executes 
BRK instruction) . A return to the 
TED can be performed at the address 
immediately after the break 
instruction, has the same effect as 
CONTROL C. 

Clear text file and turn off tape 
units. 

Copy lines y thru z in the text file 
to just after line number x. The 
copied lines will all have line 
numbers equal x. At completion, 
there will be two copies of this 
data - one at x and the original at 

y- 



>DELETE x y 



>DE 40 

>DE TOO 301 



Delete entries in text file between 
line numbers x and y inclusive. If 
only x is entered, only the first 
occurrences of that line is deleted. 



>DUPLICATE Fw 



>DUP 

>DUP F10 
>DU F 



Duplicate files from tape unit 1 to 
tape unit until file w. This com- 
mand starts by reading the next file 
on tape 1 and if that file is file w 
or an end of file mark then it stops . 
If not, the file just read will be 
written to tape and then tape 1 
is read again. This continues until 
file w or an end of file record is 
encountered. 



>FORMAT w 



>FO S 
>FO C 
>FO SET 
>FORMAT S 



Format the text file (where w = SET) 
or clear the format feature (where 
w = CLEAR) . Format set tabulates 
the text file when outputted. This 
lines up the various source statement 
fields. This feature, set or clear, 
does not require extra memory. 
Assembly output is dependent on the 
state of the format feature. 



>GET Fx y 



>HARD w x 



>GE 

>GET F13 100 
>GET APPEND 
>GET F2 A 



>HA S 1 
>HARD C 
>HA P 



Get text file with data associated 
with file number x from tape. The 
data will be loaded at line number 
y, or will be appended to end of the 
text file if the key-word APPEND 
is entered for y. Defaults are x = 
00 and y = 0. 

Control output to hard COPY output 
device (printer) . Turn on outputting 
(w = SET) or turn off (w = CLEAR) . 
The starting page number is x. This 
command is designed to leave a 
small margin at top and bottom, and 
provide a page number heading at 
the top of each page. It is designed 
to work with 66 line pages. An entry 
of >HA PAGE results in the printer 
advancing to the top of the next 
page. >HA set will cause output to 
go through the printer vector in 
addition to OUTVEC. 



>LABELS 



>LA 
>LAB 



Print out the label file generated by 
the previous ASSEMBLE. 



>MANUSCRIPT w 



>MA S 
>MA C< 



>MDVE x y z 



>n 



>M0 110 10 40 
>MO 300 100 200 



>10 
>100 



If w = SET, line numbers are not 
outputted when executing the >PR 
command. If w = CLEAR, line 
numbers are outputted when the >PR 
command is executed. Assembly 
output ignores the >MA command. 
If manuscript is to be generated with 
RAE, manuscript should be set and 
format clear (>MA SET, >FO 
CLEAR) . Since the TED considers 
a blank line a deletion, one must 
enter a non-printable control char- 
acter to "trick" the TED into inser- 
ting a blank line, e.g., 'TAB' 
(CONTROL I) . 

Move lines y thru z in the text file 
to just after line number x. The 
moved lines will all have line num- 
bers equal to x. The original lines 
y thru z are deleted. 

Any entry beginning with one or 
more decimal digits is considered an 
entry/deletion of text. See Section 
3.4. 



>nnnn// 



>2000// 



>NUMBER x y 



>NU 10 
>NU 100 10 



Used to exit temporarily from auto 
line number mode so that commands 
may be entered. Entry of a line 
number rather than a command will 
cause return to auto line number 
mode. 

Renumber the text file starting at 
line x in text file and expanding by 
constant y. For example to re- 
number the entire text file by 10, 
enter >NU 10. 



>OFF n 



>ON n 



>OUTPUT Fw 



>OF 





>OF 


1 


>OFF 


>ON 





>ON 


1 


>ON 




>OU 


F 


>OU 


F14 


>OUT 



Turn off tape unit n, where n is 
(record unit), or 1 (play unit). If an 
n is not entered, is assumed. 

Turn on tape unit n, where n is 
(record unit), or 1 (play unit). If an 
n is not entered, is assumed. 

Create a relocatable object file on 
tape unit and assign file number 
w to the recorded data. If w is not 
entered 00 will be assumed. This 
command uses the 256 byte relocat- 
able buffer that can be relocated 
via the >SET command. 



>PASS 



>PA 
>PASS' 



Execute the second pass of assembly. 
Not required if source is all in 
internal memory and the .CT pseudo op 
is not encountered. 



>PRINT x y 



>PUT Fw x y 



>PR 

>PRINT 10 
>PRINT 100 301 



>PU F13 

>PU F13 200 300 

>PUT F 

>PUT 



Print the text file data between line 
number x and y on the terminal. If 
only x is entered, only that line is 
printed. If no x and y, the entire 
file is outputted. 

Put text file between lines x and y 
inclusive to tape, and assign the 
recorded data file number w. If w 
is not entered, 00 will be assumed. 
If x and y are not entered, the entire 
text file is recorded. If the letter 
X is entered as the parameter such 
as >PU X an end of file mark is 
recorded. 



>RUN label expression 



>RU START 
>RU $1000 
>RUN TEST+5 



Run (execute) a previously assembled 
program. If a symbolic label is 
entered, the label file is searched 
for its value. The called program 
should contain a JMP warm start 
(4C03B0) as the last executable 
instruction. 



>SET ts te Is le bs 

>SE 

>SE $1000 $2000 $200 $3FF $400 

>SET 



If no parameters are given, the text 
file, label file, and relocatable buf- 
fer boundaries (addresses indicating 
text file start, end, label file 
start, end, and relocatable buffer 
start) will be output on the first 
line, then on the second line the 
output consists of the present end of 
data in the text file followed with 
the present end of data in the label 
file. If parameters are entered, the 
first two are text file start (ts) and 
end (te) addresses, then the label 
file start (Is) and end (le) 
addresses, and finally the relocatable 
buffer start address (bs) . Parameters 
may be entered either in decimal form, 
or if preceded by a $, in hex form. 



>USER 



>us 

>USR 



User defined command. The RAE 
will transfer control to location 
$0003. The user routine can re-enter 
RAE via a JMP warm start (4C03B0) . 



>LOAD f x 



>ENTER f x 



>LOAD DUMP 
>LO RX320c 4 



>ENTER DUMP 
>EN RX320c 4 



GoertzWorks! Ram Model only. Load file 
name f from floppy device x. If source 
file is not clear loaded source will 
be appended at the end of the current 
source file. Requires S2MDOS to 
function. 

GoertzWorks! Ram Model only. Save file 
name f to floppy device x. Requires 
SYMDOS to function. 



Floppy I/O functions are attached to RAE by issuing a call to RAEENTRY in SXMDOS 
once RAE is running. Floppy device [0,4], [1,5], [2,6], and [3,7], are the same 
device except device 4, 5, 6, and 7 perform a write verify when saving. 



I 



3.2 EDIT AND FIND COMMANDS 

STRING SEARCH AND REPLACE (EDIT) COMMAND 

>EDIT string or >EDIT n 

A powerful string search and replace, and line edit capability are 
provided via the >EDIT command to easily make changes in the text file. 
Use Form 1 to string search and replace, and Form 2 to edit a particular 
line. 

FORM 1 # 

>EDIT tSltS2t %d ~ x y 

where : 

t is any non numeric terminator, e.g., ".", "/". 

51 is the string to search for. 

52 is the string to replace SI. 

d is the "don't care" character. Precede with % character to 
change the don't care; this character used within SI indicates 
which position to ignore for a search "match" condition. 

* indicates to interact with user via subcommands before 
replacing SI (see below) . 

(a space character) indicates to alter and print all lines 
altered. 

# indicates to alter but provide no printout. 
x line number start in text file. 

y line number end in text file. 

Asterisk * prompted subcommands: 

A alter field accordingly. 

D delete entire line. 

M move to next field - don't alter 

S skip this line - don't alter 

X exit >ED command 

CONTROL F enter form 2 

Form 1 Defaults: 

d = % 

x = 

y = 9999 

~ = (space) print all lines altered 



For example, to replace all occurrences of the label LOOP with the label START 
between lines 100 and 600, enter: 

>EDIT /LOOP/START/ 100 600 
To simply delete all occurrences of LOOP, enter: 

>EDIT /LOOP// 100 600 

Use the * and # as described. 

The slash was used in the above examples as the terminator but any non-numeric 
character may be used. 

At the end of the >EDIT operation, the number of occurrences of the string will 
be output as //xxxx where xxxx is a decimal quantity. 

FORM 2 

>EDIT n 

where : 

n is line number (0-9999) of line to be edited. 

Subcommands : 

CONTROL F Find user specified character. 

CR carriage return. Retain remaining part of line. 

CONTROL D Delete any remaining part of line. 

CONTROL H Delete a character. 

For example, to change LDA to LDY in the following line, 

LOOP1 LDA #L,CRTBUFFER ; LOAD FROM BUFFER 

type CONTROL F followed with A, then CONTROL H, then Y, and 
then terminate line with a carriage return. 

The corrected line will be outputted and entered in the text file. 

FIND STRING SI COMMAND 

Used to find certain occurrences of a particular string. It's form is: 

# 

>FIND tSlt %d ~ x y 

where : 

t, SI, %, d, x, y are as defined in the EDIT command, FORM 1. 
*/ ~ indicates print all lines containing occurrences of SI. 
# indicates no printout. 



At the end of the >FIND operation, the number of occurrences of the 
string will' be output as //xxxx where xxxx is a decimal quantity. 

A unique use of this command is to count the number of characters in 
the text file (excluding line numbers). The form for this is: 

>FIND /%/# 

3.3 HOW TO USE EDIT AND FIND 

We will show with a simple example, how to use some of the EDIT features of RAE. 
Other features, such as the use of a "don't care" character in string searching, 
and the control of the degree of user interaction, are described elsewhere in 
this manual. FIND is used to search for, but not alter, strings. It is 
particularly useful in finding cross-references in a source code; its use is 
like that of the form of EDIT which does not use a line number. 

Let the text to be edited be manuscript, rather than source code. SET FORMAT 
CLEAR, AUTO 10, and enter the manuscript. After entry, print and examine, and 
make the desired corrections. 

For example, let the manuscript read: 

"10 Now is the time for all good men" 
and let it be corrected to read 

"10 Now is the best time for most good women" 

The procedure is as follows 

>pr 

0010 Now is the time for all good men 

LL 

>ed 10 

Now is the time for all good men 

A F >eNow is the best A F>l time for al A F>ll\\\most 

0010 Now is the best time for most good men 
>ed /mem/ women/* 
23 0010 Now is the best time for most good men * a 

0010 Now is the best time for most good women 

//0001 

>pr 
0010 Now is the best time for most good women 

// 



All underlined characters and symbols are RAE outputs. 

For insertions, find the starting point and enter new material, ending with 
RETURN . 

For deletions, find the end of the string, and delete with either DELETE, RUBOUT 
or CONTROL H, depending on the type of terminal. New material may then be added 
if desired; if not hit RETURN. 



The CONTROL Fe was entered to find the "e" in "The". 

'all". 

The "*" was used to permit interaction in case the string being searched for had 
multiple occurrences, and replacement was to be on a selective basis. The "23" 
is the count (in hex) to the start of the string /man/ in line 0010. The "a" is 
user approval to alter; entry of "s" would skip the alteration. 

When editing is completed, enter MANUSCRIPT SET, to inhibit line number 
printing, and print the final copy. The process is less complicated than it 
would appear from the example, and will soon become almost automatic; the user 
will see, almost at once, simpler, though less illustrative, means for 
accomplishing the editing above. 

It is good operating procedure to have a backup copy of the material which is 
being edited on tape, in case of operator errors with the MO, CO, DE, etc. 
commands . 

3.4 ENTRY/DELETION OF TEXT 

Source is entered in the text file by entering a line number (0-9999) followed 
by the text to be entered. The line number string can be one to n digits in 
length. If the string is greater than 4 digits in length, only the right-most 4 
are considered. Text may be entered in any order but will be inserted in the 
text file in numerical order. This provides for assembling, printing, and 
recording in numerical order. Any entry consisting of a line number with no text 
or just spaces results in a deletion of any entry in the text file with the same 
number. If text is entered and a corresponding line number already exists in the 
text file, the text with the corresponding number is deleted and the entered 
text is inserted. 

TO DELETE THE ENTIRE FILE, use the >CL command. 

TO DELETE A RANGE OF LINES, use the >DE command. 

TO EDIT AN EXISTING LINE or lines having similar characteristics, 
use the >ED command. 

TO FIND A STRING, use the >FI command. 

TO MOVE OR COPY LINES use the >MO or >CO commands. 

TO COPY FROM INPUT TAPE TO OUTPUT TAPE until a specific 
file, use the >DU command. 

The terminal input buffer is 80 characters in length. There are 9 tab points 
preset at 8 character intervals. Thus, the first tab point is at the 8th column, 
the second at the 16th column, etc. Entry of TAB or CONTROL I will result in a 
movement to the next tab point. When inputting, the cursor may not position 
exactly at the tab point but will position properly when the text file is 
outputted via the >PR command. 

Text may be entered more easily by use of the auto line numbering feature (>AU 
command) . Any >AU x where x does not equal puts the TED in the auto line 
number mode. To exit from this mode, type >//. 



When entering source for the assembler, one' need not space over to line up the 
various fields. Labels 'are entered immediately after the line number or > when 
in auto line numbering. Separate each source field with one or more spaces. If 
the format feature is set (see >F0 command), the TED will automatically line up 
the fields. Note: If a space is entered before the label, the TED will line up 
the label in the next field. This should result in an assembler error when 
assembled. If a control I (tab) is entered, a tab to the 8th column is formed. 
These tabs are preset and can not be changed. Commands, mnemonics, and pseudo 
ops may be entered as upper case or lower case characters. Assembly labels may 
also be entered in upper or lower case but a label entered as upper case will be 
different from the same label entered as lower case. 



SECTION 4.0 
ASSEMBLER (ASM) 

4.1 ASSEMBLER FEATURES 

The ASM scans the source program in the text file. This requires at least two 
passes (or scans) . On the first pass, the ASM generates a label file ( or symbol 
table) and outputs any errors that may occur. On the second pass the ASM creates 
a listing and/or object file using the label file and various other internal 
labels. 

A third pass (via >OU) may be performed in order to generate a relocatable 
object file of the program in the text file. This file is recorded on tape unit 
and may be reloaded into the memory using the relocating loader at practically 
any location. 

4.2 SOURCE STATEMENT SYNTAX 

Each source statement consists of five fields as described below: 

line number label mnemonic operand comment 

Line number 

The line number is any number between and 9999. If more than 4 numbers are 
inputted, only the last 4 digits are recognized. 

Label 

The first character of a label may be formed from the following characters: 

@ A thru Z [\] A 

while the remaining characters which form the label may be constructed from the 
above set plus the following characters: 

. / thru 9 : ; < > ? 

The label is entered immediately after the line number or prompt (>) if in the 
auto line numbering mode. 

Mnemonic or Pseudo Op 

Separated from the label by one or more spaces and consists of a standard 6502 
mnemonic from Table A or pseudo op from Table B. 

Operand 

Separated from mnemonic or pseudo op by one or more spaces and may consist of a 
label expression from Table C and symbols which indicate the desired addressing 
mode from Table D. 



Comment 

Separated from operand field by one or more spaces or tabs and is free format. A 
comment field begins orte or more spaces past the mnemonic or pseudo op if the 
nature of such does not require an operand field. A free format comment may be 
entered if a semicolon (;) follows the line number or > if in auto line 
numbering mode . 

For converting 6502 assembly language programs written on the System 65 or on 
MOS Technology Timesharing Cross Assembler, refer to Appendix C. 

TABLE A - 6502 MNEMONICS 



For a description of each mnemonic, consult the MNA-2 SY6500 
Programming Manual . 



ADC 


CLD 


JSR 


RTS 


AND 


CLI 


LDA 


SBC 


ASL 


CMP 


LDX 


SEC 


BCC 


CLV 


LDY 


SED 


BCS 


CPX 


LSR 


SEI 


BEQ 


CPY 


NOP 


STA 


BIT 


DEC 


ORA 


STX 


BMI 


DEX 


PHA 


STY 


BNE 


DEY 


PHP 


TAX 


BPL 


EOR 


PLA 


TAY 


BRK 


INC 


PLP 


TSX 


BVC 


INX 


ROL 


TXA 


BVS 


INY 


ROR 


TXS 


CLC 


JMP 


RTI 


TYA 



TABLE B - PSEUDO OPS 



NAME 



EXAMPLE 



PURPOSE/USE 



. BA expression 



.BA $200 



Begin assembly at the address 
calculated from the label expression. 
This address must be defined on the 
first pass or an error will result and 
the assembly will halt. 



.BY 



.BY 00 'ABCD' 47 69 'Z' $FC %1101 



.CE 



,CE 



Store bytes of data. Each hex, decimal, 
or binary byte must be separated by at 
least one space. An ASCII string may 
entered by beginning and ending with 
apostrophes ( ' ) . 

Continue assembly if errors other than 
!07, !04, or ! 17 occur. All error 
messages will be printed. 



.CT 



.CT 



Indicates that the 
continues to tape. 



source program 



label .DE expression 



IN -DE INDEV 



Assign the address calculated from the 
expression to the label. Designate as 
external and put in label file. An 
error will result if the label is 
omitted. 



label .DI expression 



ASCII .DI TABLE Assign the address calculated from the 
expression to the label. Designate as 
internal and put in label file. An 
error will result if the label is 
omitted. 



.DS expression 



.EC 



.EJ 



.EN 



.ES 



.LC 



.LS 



!!!label .MD (pi p2 p3. 
.MC expression 



.DS 20 ' 
.DS $00F0 



.EC 



.EJ 



• EN 



.ES 



.LC 



.LS 



) 

.MC $700 
.MC CAT ■ 
.MC ORIGIN+$1000 



Define a block of storage. For example, 
if expression equated to 4, then ASM 
will skip over 4 bytes. Note: The 
initial contents of the block of 
storage are undefined. 

Suppress output of macro generated 
object code on source listing. See 
Section 4.7. This is the default 
condition. 

Eject to top of next page if >HA SET 
was previously entered. 

Indicates the end of the source 
program. 

Output macro generated object code on 
source listing. See Section 4.7. 

Clear the list option so that the 
assembly terminates printing the source 
listing after the .LC on pass 2. 

Set the list option so that the assembly 
begins printing out the source listing 
after the .LS on pass 2. 

Macro definition. See Section 4.7. 



When storing object code, move code to 
the address calculated from the 
expression but assemble in relation to 
that specified by the .BA pseudo op. An 
undefined address results in an 
immediate assembly halt. 



.ME 



.ME 



Macro end. See Section 4.7. 



.oc 



.OS 



.RC 



.OC 



.OS 



.RC 



.RS 



.RS 



. SE expression 



.SE BASIC 
.SE $C000 



.SI expression 



.SI START 
.SI TABLE 
.SI =+4 



Clear the object store option so that 
object code after the -OC is not stored 
in memory. This is the default option. 

Set the object store option so that 
object code after the .OS is stored in 
memory on pass 2. 

Provide directive to relocating loader 
to resolve address information in the 
object code per relocation requirements 
but store code at the pre-relocated 
address. This condition remains in 
effect until a .RS pseudo op is 
encountered. The purpose of the .RC op 
is to provide the capability to store 
an address at a fixed location (via .SI 
pseudo op) which links the relocatable 
object code module to a fixed module. 

Provide directive to relocating loader 
to resolve address information in the 
object code per relocation, and store 
the code at the proper relocated 
address. This is the default condition. 

Store the address calculated from the 
expression in the next two memory 
locations. Consider this address as 
being an external address. Note: If a 
label is assigned to the .SE, it will 
be considered as internal. 

Store the address calculated from the 
expression in the next two memory 
locations. Consider this address as 
being an internal address. 



NOTE 



Labels may be entered with any of the pseudo 
ops, but are mandatory where indicated. 



TABLE C - EXPRESSIONS 

An expression must not contain embedded spaces and is constructed from the 
following: 

Symbolic Labels: 

One to ten characters consisting of the ASCII characters as previously defined. 



Constants : 

Decimal, hex, or binary values may be entered. If no special symbol precedes the 
numerals then the RAE assumes decimal (example: 147). If $ precedes then hex is 
assumed (example: $F3) . Only the last four hex digits are used. If % precedes 
then binary is assumed (example: % 11001) . Leading zeros do not have to be 
entered. All numbers greater than 65,536 are reduced modulo 2 . 

Program Counter: 

To indicate the current location of the program counter use the symbol = . 

Arithmetic Operators: 

Used to separate the above label representations: 

+ addition, - subtraction 

Examples of some valid expressions follow: 

LDA #%1101 load immediate 00001101 

STA *TEMP+$01 store at byte following TEMP; Zero page 
LDA $471E36 load from $1E36; 47 is ignored 
JMP LOOP+C-$4 61 

BNE =+8 branch to current PC plus 8 bytes; current PC is 

first byte of next instruction 

One reserved symbol is A, as in ASL A. The letter A followed with a space in the 
operand field indicates accumulator addressing mode. 

ASL A+$00 does not result in accumulator addressing but instead references a 
memory location. 

TABLE D - ADDRESSING MODE FORMAT 

Immediate 

LDA #%1101 binary 00001101, the ' pound sign (#) indicates 

immediate addressing 

LDA #$F3 hex F3 

LDA #F3 load value of label F3 

LDA #'A ASCII A 

LDA #H, expression hi part of the value of the expression 

LDA #L, expression lo part of the value of the expression 

Absolute 

LDA expression 

Zero Page 

LDA *expression the asterisk (*) indicates zero page 

addressing 



Absolute Indexed 

LDA expression, X 
LDA expression, Y -" 

Zero Page Indexed 

LDA *expression,X 
LDX *expression, Y 

Indexed Indirect 

LDA (expression, X) 
Indirect Indexed 

LDA (expression) , Y 
Indirect 

JMP (expression) 
Accumulator 

ASL A letter A indicates accumulator addressing mode 

Implied 

TAX operand field ignored 

CLC 

Relative 

BEQ expression 

4.3 LABEL FILE (OR SYMBOL TABLE ) 

A label file is constructed by the assembler and may be outputted at the end of 
assembly (if an .LC pseudo op was not encountered) or via the >LA command. The 
output consists of each label encountered in the assembly and its hex address. A 
label in the label file which begins with a slash (/) indicates that it was 
defined as an external label. All others are considered as being internal 
labels. When a relocatable object file is generated (via >0U command), any 
instruction which referenced an internal label or a label expression which 
consisted of at least one internal label will be tagged with special information 
within the relocatable object file. The relocating loader uses this information 
to determine if an address needs to be resolved when the program is moved to 
another part of memory. 

Conversely, instructions which referenced an external label or a label 
expression consisting of all external references will not be altered by the 
relocating loader. 

At the end of the label file the number of errors which occurred in the assembly 
will be outputted in the following format: 

//xxxx, yyyy, zzzz 



where xxxx is the number of errors found in decimal representation, yyyyy is 
last address in relation to -BA, and zzzz is last address in relation to .MC. 

4.4 ASSEMBLING FROM MEMORY 

With the source program in the text file area, simply type >AS x. Assembly will 
begin starting at line number x. If a .CT pseudo is not encountered, both passes 
will be accomplished automatically. If a .CT pseudo op is encountered, the >PA 
command would have to be executed to perform the second pass. 

4.5 ASSEMBLING FROM TAPE 

Source for a large program may be divided into modules, entered into the text 
file one at a time and recorded (>PU) on tape. 

At assembly, the assembler can load and assemble each module until the entire 
program has been assembled. This would require two passes for a complete 
assembly. When assembling from tape, the file identification numbers assigned to 
the modules are ignored. NOTE: SYM users should refer to Section 10.0, paragraph 
4, before assembling from tape. 

Source statements within a module will be assembled in numerical order but the 
modules will be assembled in the order in which they are encountered. Source 
statement numbering is restarted for each module. If a line number is specified 
in the >AS command indicating the start of assembly, it applies for all modules. 

The ASM assumes that if an end of file condition is encountered before the .EN 
pseudo op and a .CT pseudo op had not been encountered, an error is present (!07 
AT LINE xxxx) . 

When assembling from tape, the assembler should encounter a .CT pseudo op before 
the end of the first module. Two ways to accomplish this are: 

1. a) Load the first module via the >GE command, 
b) This module should contain a .CT pseudo op. 

or 

2. a) Clear the text file via the >CL command. 

b) Enter >9999 .CT. 9999 is entered since one may have requested any 
assembly beginning with a line number. This insures that the .CT 
gets executed. 

Next ready the play unit and type >AS x. Either way the ASM will start and stop 
tape unit 1 until the .EN pseudo op is encountered. At that point tape unit 1 is 
turned off, and the message RDY. FOR PASS 2 is outputted. 

RAE is now in the TED mode. Rewind the tape unit (>ON 1 and >OFF 1 accordingly) . 
Perform 1 or 2 as described above and type >PASS to perform the second pass. 
Again tape unit 1 will be turned on and off accordingly under control of the ASM 
software. 

4.6 CREATING A RELOCATABLE OBJECT FILE 

In order to create a relocatable object file, the programmer should define those 
labels whose address should not be altered by the relocating loader. This is 
done via the .DE pseudo op. Constants (example: $0169) are also considered as 
being external. All other labels (including those defined via the .DI pseudo op) 



are considered as internal. Addresses associated with internal labels are 
altered by an offset when the program is loaded via the relocating loader. 
Also .SE stores a two byte external address and .SI stores a two byte internal 
address. Similarly the 'relocating loader will alter the internal address and not 
the external address. 

An example of an external address would be the calls to the system monitor or 
any location whose address remains the same no matter where the program is 
located. Locations in zero page are usually defined as external addresses. 
Expressions consisting of internal and external labels will be combined and 
considered an internal address. A label expression consisting entirely of 
external labels will be combined and considered as external. 

To record a relocatable object file, insert a blank tape in tape unit and 
ready. If the entire source program is in memory, simply type >0U. 

If the source program is on tape type >0U, the ASM will turn both tape units on 
and off until the end of assembly. The relocatable object file will be recorded 
on the tape in unit 0. 

After the relocatable object file has been recorded, record an end of file mark 
via the >PU X command. 

4.7 MACROS 

RAE provides macro capability. A macro is essentially a facility in which one 
line of source code can represent a function consisting of many instruction 
sequences. For example, the 6502 instruction set does not have an instruction to 
increment a double byte memory location. A macro could be written to perform 
this operation and represented as INCD (VALUE. 1). This macro would appear in 
your assembly language listing in the mnemonic field similar to the following: 

BNE SKIP 
NOP 



INCD ( VALUE. 1) ; INCREMENT DOUBLE 
LDA TEMP 



Before a macro can be used, it must be defined in order for ASM to process it. A 
macro is defined via the .MD (macro definition) pseudo op. Its form is: 

!!!label .MD (11 12 . . . In) 

Where label is the name of the macro (!!! must precede the label), and 11, 
12,..., In are dummy variables used for replacement with the expansion 
variables. These variables should be separated using spaces, do not use commas. 

To terminate the definition of a macro, use the .ME (macro end) pseudo op. 

For example, the definition of the INCD (increment double byte) macro could be 
as follows: 



!!!INCD .MD , (LOC) /INCREMENT DOUBLE 

INC LOC 

BNE :■ SKIP 

INC LOC+1 
SKIP .ME 

This is a possible definition for INCD. The assembler will not produce object 
code until there is a call for expansion. Note that a call for expansion occurs 
when you enter the macro name along with its parameters in the mnemonic field 
as: 

INCD (TEMP) or INCD (COUNT) or INCD (COUN+2) 

or any other labels or expressions you may choose. 

NOTE 

In the expansion of INCD the code to increment the 
variable LOC is not being generated; instead the code to 
increment the associated variable in the call for 
expansion. Also parentheses must be used with the 
parameter labels both in the definition and in the call. 

If you tried to expand INCD as described above more than once, you will get a 
!06 error message. This is a duplicate label error and it would result because 
of the label SKIP occurring in the first expansion and again in the second 
expansion. 

There is a way to get around this and it has to do with making the label SKIP 
appear unique with each expansion. This is accomplished by rewriting the INCD 
macro as follows: 

; INCREMENT DOUBLE 



•"■ 



! ! ! INCD 


.MD 


(LOC) 




INC 


LOC 




END 


. . . SKIP 




INC 


LOC+1 


. . . SKIP 


.ME 





The only difference is ...SKIP is substituted for SKIP. What the ASM does is to 
assign each macro expansion a unique macro sequence number (2 maximum macros 
in each file) . If the label begins with . . . the ASM will assign the macro 
sequence number to the label. Thus, since each expansion of this macro gets a 
unique sequence number, the labels will be unique and the !06 error will not 
occur. 

If the label ...SKIP also occurred in another macro definition, no !06 error 
will occur in its expansion if they are not nested. If you nest macros (i.e., 
one macro expands another), you may get a !06 error if each definition uses the 
. . .SKIP label. 

The reason this may occur is that as one macro expands another in a nest, they 
are each sequentially assigned macro sequence numbers. As the macros work out of 
the nest, the macro sequence numbers are decremented until the top of the nest. 
Then as further macros are expanded, the sequence numbers are again incremented. 
The end result is that it is possible for a nested macro to have the same 



c 



sequence number as one not nested. Therefore' if you nest macros, it is suggested 
that you use different labels in each macro definition. 

Some further notes on macros are: 

1. The macro definition must occur before the expansion. 

2. The macro definition must occur in each file that references it. Each 
file is assigned a unique file sequence number (2 16 maximum files in 
each assembly) which is assigned to each macro name. Thus the same 
macro definition can appear in more than one file without causing a 
!06 error. If a macro with the same name is defined twice in the same 
file, then the !06 error will occur. 

3. Macros may be nested up to 32 levels. This is a limitation because 
there is only so much memory left for use in the stack. 

4. If a macro has more than one parameter, the parameters should be 
separated using spaces - do not use commas. 

5. The number of dummy parameters in the macro definition must match 
exactly the number of parameters in the call for expansion. 

6. The dummy parameters in the macro definition must be symbolic labels. 
The parameters in the expansion may be symbolic or non-symbolic label 
expressions. 

7. if the . ES pseudo op is entered, object code generated by the macro 
expansion will be output in the source listing. Also, comment lines 
within the macro definition will be output as blank lines during 
expansion. If .EC was entered, only the line which contained the macro 
call will be output in the source listing. 

4.8 CONDITIONAL ASSEMBLY 

ASM also provides a conditional assembly facility to conditionally direct the 
assembler to assemble certain portions of your program and not other portions. 
For example, assume you have written a CRT controller program which can provide 
either 40, 64 or 80 characters per line. Instead of having to keep 3 different 
copies of the program you could use the ASM conditional assembly feature to 
assemble code concerned with one of the character densities. 

Before we continue with this example, let us describe the conditional assembly 
operators : 

IFE expression If the expression equates to a zero quantity, 

then assemble to end of control block. 

IFN expression If the expression equates to a non zero 

quantity then assemble to end of control block. 

IFP expression If the expression equates to a positive 

quantity (or 0000), then assemble to end of 
control block. 



IFM expression 



If the expression equates to a negative (minus) 
quantity, then assemble to end of control 
block. 



*** 



Three asterisks in the mnemonic field indicates 
the end of the control block. 



SET symbol = expression 



Set the previously defined symbol to the 
quantity calculated from the expression. 



NOTE 

All expressions are evaluated using 16 bit precision 
arithmetic. 



Going back to the CRT controller software example, a possible arrangement of the 
program is as follows: 



CHAR. LINE 



.DE 40 



IFE CHAR.LINE-40 
;CODE FOR 40 CHAR. /LINE 



*** 

IFE CHAR.LINE-64 
;CODE FOR 64 CHAR. /LINE 



*** 

IFE CHAR.LINE-80 
?CODE FOR 80 CHAR.ILINE 



*** 
; COMMON CODE 

Shown is the arrangement which would assemble code associated with 40 characters 
per line since CHAR. LINE is defined as equal 40. If you wanted to assemble for 
80 characters, simply define CHAR. LINE as equal 80, with SET CHAR. LINE = 80. 

Conditional assembly can also be incorporated within macro definitions. A very 
powerful use is with a macro you don't want completely expanded each time it is 
referenced. For example, assume you wrote a macro to do a sort on some data. It 
could be defined as follows: 



EXPAND .DE 
!!!SORT .MD 

IFN EXPAND 

JSR SORT. CALL ;CALL SORT 

**• 



IFE EXPAND 
JSR SORT. CALL 
JMP . . . SKIP 

,-SORT CODE FOLLOWS 

SORT . CALL 



RTS 
. . SKIP SET EXPAND = 1 

*•* 

.ME 



In this example, EXPAND is initially set to 0. When the macro is expanded for 
the first time, EXPAND equals and the code at SORT. CALL will be assembled. 
Also, the first expansion sets EXPAND to I. On each succeeding expansion, only a 
JSR instruction will be assembled since EXPAND equals 1. Using conditional 
assembly in this example resulted in more efficient memory utilization over an 
equivalent macro expansion without conditional assembly. 

4.9 ASSEMBLER DEFAULT PARAMETERS 

* Assumes assembling from memory (otherwise use .CT) . 

* Does not store object code in memory (otherwise use .OS) . 

* Begins assembly at $0200 (otherwise use .BA) . 

* Output listing clear (otherwise use .LS or >ASSEMBLE LIST) . 

* Stops assembly on errors (otherwise use .CE) . 

* Stores object code beginning at $0200 unless a .BA or .MC is 
encountered and if .OS is present. 

* Generates relocatable addresses. 

* Macro object code is not output (otherwise use . ES) . 



SECTION 5.0 

RELOCATING LOADER 

A source listing of the relocating loader (Appendix D) is provided. The 
relocating loader is not part of the RAE program body, and the user will have to 
enter it via the listing. 

If you prefer to have the loader reside in some other part of memory, you should 
enter the source into the text file, assemble, and then create a relocatable 
object file on tape. 

To record a program in relocatable format, first assemble (without an .OS pseudo 
op) the program at location 0000 (.BA $0). Next create a relocatable object file 
via the >OU command. Terminate the relocatable object file with an end of file 
mark via the >PU x command. To reload a program in relocatable format, first 
enter the address where you want the program to reside in memory locations $00E0 
(lo) and $00E1 (hi), the object file number into $0110, the relocatable buffer 
address in 00C8 (lo) and 00C9 (hi) and then start execution at $0200. 

When executing the relocating loader, if an error or an end of file mark is 
detected, a break (BRK) instruction will be executed so as to return to the 
system monitor. The contents of register A indicates the following: 

00 good load 

EE error in loading 

All programs to be created in relocatable format should be assembled at $0000. 
This is because the offset put in $00E0 and $00E1 before execution is added to 
each internal address by the loader in order to resolve addresses while 
relocating the program. If the program was originated at say $1000, then one 
would have to enter F200 as the offset in order to relocate to $0200 (i.e., 
F200+1000 = 0200) . This is somewhat more confusing than an assembly beginning 
$0000. 

In addition to the program memory space, the relocating loader uses the 
following memory locations: 

00C8-00C9, 00DC-00E1 
0110, 011E-0121, 017A-0184 

plus other stack area for subroutine control. 



SECTION 6:0 

FILE NUMBERS 

Information to be recorded on or read from tape via the >PU, >GE, and >OU 
commands may be assigned a file identification number to distinguish between 
files. A file number is a decimal number between and 99. To enter a file 
number as a parameter in the >PU, >OU, or >GE commands, begin with the letter 
• F' followed by the file number. Examples are F0, F17, F6, etc. If no file 
number is entered with the >PU >GE, and >OU commands, file number will be 
assigned by default. 

When loading, all files encountered will result in the outputting of their 
associated file numbers and file length in bytes. The loaded file has, in 
addition, the memory range of the location of the loaded data. 

Example: " >GET F17 
F00 01A3 
F67 0847 

F17 0F93 0200-1193 
> 

An end of file mark may be recorded via the >PU X command to indicate the end of 
a group of files. If an end of file mark is encountered when loading, FEE will 
be outputted and a return to the command mode will be performed. 



SECTION 7i0 

ERROR CODES 

An error message of the form !xx AT LINE TTXT/ZZ where xx is the error code, 
yyyy is the line number, and zz is the file number, will be outputted if an 
error occurs. Sometimes an error message will output an invalid line number. 
This occurs when the error is on a non-existent line such as an illegal command 
input . 

The following is a list of error codes not specifically related to macros: 

17 Checksum error on tape load. 

16 Illegal tape unit number. 

15 Syntax error in >ED command. 

14 Cannot generate relocatable object tape with errors or no previous 

assembly. 

11 Missing parameter in >NU command. 

10 Overflow in line # renumbering 

CAUTION: You must properly renumber the text file or part of the 

file may be deleted by subsequent operations. 

OP Overflow in text file - line not inserted. 

0E Overflow in label file - label not inserted. 

0D Expected hex characters, found none. 

0C Illegal character in label. 

OB Unimplemented addressing mode. 

0A Error in or no operand. 

09 Found illegal character in decimal string. ,.r 

08 Undefined label {may be illegal label) . | 

07 .EN pseudo op missing. 

06 Duplicate label. 

05 Label missing in -DE or .DI pseudo op. 

04 .BA or .MC operand undefined. 

03 Illegal pseudo op. 

02 Illegal mnemonic. 

01 Branch out of range. 

00 Not a zero page address. 

ED Error in command input . 

The following is a list of error codes that are specifically related to macros: 

2F Overflow in file sequence count; 2 maximum. 

2E Overflow in number of macros; 2 maximum. 

2B .ME without associated .MD. 

2A Non-symbolic label in SET. 

29 Illegal nested definition. 

27 Macro definition overlaps file boundary. 

26 Duplicate macro definition. 

25 Number of macro reference parameters is different from the number of 

macro dummy parameters or illegal characters. 

24 Too many nested macros; 32 maximum. 

23 Macro definition not complete at .EN. 

22 Conditional suppress set at .EN. 

21 Macro in expand state at .EN. 

20 Attempted expansion before definition. 



SECTION 8.0 

CONTROL CODES 

ASCII characters whose hex values are between hex 00 and 20 are normally 
nonprinting characters. With a few exceptions, these characters will be output 
in the following manner; A C where C is the associated printable character if hex 
40 was added to its value. For example, ASCII 03 will be output as A C, 18 as A X, 
etc. 

In addition, some of these control codes have special functions in RAE. 

Control codes which have special functions are: 



CONTROL B 
CONTROL C 
CONTROL D 
CONTROL F 
CONTROL C * 
CONTROL H * 
CONTROL L * 
CONTROL J * 
CONTROL M * 
CONTROL O 

CONTROL Q * 
CONTROL Tn 
CONTROL X 
CONTROL Y 

CONTROL Z 
CONTROL [ * 



go to BASIC. 

go to System Monitor (executes BRK instruction) . 

delete - used by >EDIT form 2. 

find - used by >EDIT form 1 and form 2 . 

bell. 

backspace (delete previous character) . 

horizontal tab. 

line feed. 

carriage return. 

continue processing after break key but suppress output 

to CRT. 

continue after break key. 

(as CONTROL Tn) toggle motor control on tape unit n. 

delete entire line entered. 

jump to location $0000. Return via JMP to B0B1 . NOTE: 

location $0000 must first be initialized by the user. 

terminate processing and go to ">" mode after break key 

escape character. 



- Non-printing control character. 



SECTION 9i0 
SPECIAL NOTES 

* In addition to the program memory space the RAE uses the following memory 
locations: 

0100 - up depending on type of function 

00B6 - 00FF reserved for RAE and system monitor 

plus other stack area for subroutine control. The terminal input buffer is in 
locations 0135 - 0185. 

* Keep the cover closed on the tape unit as this keeps the cassette cartridge 
stable. 

* When entering source modules (without .EN) you can perform a short test on 
the module by assembling the module while in the text file and looking for 
the !07 error. If other error messages occur, you have errors in the module. 
This short test is not a complete test but does check to make sure you have 
lined up the fields properly, not entered duplicate labels within the module, 
or entered illegal mnemonics or addressing modes. 

* A 64 character/line (or greater) output device should be used with this 
program when outputting an assembly listing in order to provide a neat 
printout. 

* Any keyboard input greater than 80 characters in length will be automatically _..« 
inserted in the text file without the user having to enter a carriage return. I 

* Locations $00D5 (lo) and $00D6 (hi) contain the address of the present end of 
the label file. These locations contain invalid data until after the first 
assembly. This address +2 should contain a zero (a forward pointer) . 

* Locations $00D3 (lo) and $00D4 (hi) contain the address of the present end of 
the text file. This address +2 should contain a zero (a forward pointer) . 

* To find the address of an entry in the text file, output the line via the PR 
command, issue the BR command, and then get the contents of memory location 
00DD, 00DE. This is an address which points to the end of the outputted line. 



SECTION, 10.0 
SPECIFIC APPLICATION NOTES 

1. The default file boundaries for RAE are: text file = 0200-OBFC, label file 
= 0C00-0EFC, and relocatable buffer = 0F00. When entering the file 
boundary via the SET command, enter the end address minus 3. 

Example: If the end = OBFF, then enter OBFC. 

2. RAE provides software for controlling two tape motors. RAE assumes the 
record unit (unit 0) is connected to the SYM motor control. If the user 
implements motor control hardware for the play unit (unit 1), RAE can 
control it via APB7, pin A-15 ("1" = off, "0" = on). 

3. _ MDT1000 has both unit and unit 1 remote motor control hardware as 

standard hardware. 

4. The following must exist for installation of RAE-1/2 (two 4K ROMs) into 
SYM. 

RAE P/N 02-0023 inserted into socket U22 and 
RAE P/N 02-0024 inserted into socket U23 

The jumpers must be configured as follows: 

C-l H-3 

D-l L-46, 46* 

G-2 M-15, 16 

5. The following must exist for installation of RAE-1 (one 8K ROM) into SYM. 

RAE-1 (P/N 02-0053A) in socket U23 

The jumpers must be configured as follows: 

D-l 

M-15, 16, 46, 47* 

Add the following: 

jumper 4 to U2-1 
Jumper H to U2-2 

(U2 is an inverter located to the right of logo) 

RAE-1 (P/N 02-0053B) in socket U23 

The jumpers must be configured as follows: 

D-l 
H-4 
M-15, 16, 46, 47* 

For both versions, remove jumper from D to 3 and also jumper from H to 6. 



6. A manually-entered patch is required 'for RAE-1 VI. when used on SYM for 
assembly from cassette tape. The user must enter a flag and a vector into 
zero page. The patch may be stored any place in RAM which does not 
conflict with RAE-1, SYM-1, or application software. Since RAE-1 cold 
start entry clears the flag to zero, the patch must be entered after first 
transferring control to RAE-1 and then exiting RAE-1. 

* In early versions of SYM-1, jumper points 46 and 47 are not labeled. For 
these boards, jumper points 46 and 47 are identical to U10-7 and U10-9, 
respectively. 

The patch shown below is placed at the end of the default label file. 

LOCATION CONTENT COMMENT 



EE 


01 


Enter flag 


F6 " 


F5 


Enter vector to 


F7 


0E 


. . .patch 


EF5 


AD 


Patch is 3 


EF6 


11 


. . .instructions 


EF7 


01 




EF8 


DO 




EF9 


03 




EFA 


8D 


Store into 


EFB 


10 


location $110 


EFC 


01 




EFD 


4C 


Jump back into 


EFE 


68 


RAE-1 


EFF 


EF 





I 



To install the patch, perform the following: 

1. Enter RAE-1 Type: G B000 <CR> 

2. Exit RAE-1 Type: BR <CR> 

3. Use M command three times to 
modify EE, F6-F7, and EF8-EFF 

4. Return to RAE warm entry Type: G <CR> 



Appendices 



DECIMAL HEX CHAR 



APPENDIX A 
ASCII CHARACTER CODES 
DECIMAL HEX CHAR 



LF= Line Feed 



DEL=Rubout 



FF=Form Feed 



"=Control Key 



DECIMAL HEX CHAR 



000 


000 


NUL 


043 


02B 


+ 


086 


056 


V 


001 


001 


SOU 


044 


02C 


/ 


087 


057 


W 


002 


002 


STX 


045 


02D 


- 


088 


058 


X 


003 


003 


ETX 


046 


02E 


. 


089 


059 


Y 


004 


004 


EOT 


047 


02F 


/ 


090 


05A 


Z 


005 


005 


ENQ 


048 


030 





091 


05B 


[ 


006 


006 


ACK 


049 


031 


1 


092 


05C 


\ 


007 


007 


BEL 


050 


032 


2 


093 


05D 


] 


008 


008 


BS 


051 


033 


3 


094 


05E 


/s 


009 


009 


HT 


052 


034 


4 


095 


05F 




010 "" 


"00 A 


LF 


053 


' 035 


5 


096 


060 


\ 


Oil 


00B 


VT 


054 


036 


6 


097 


061 


a 


012 


OOC 


FF 


055 


037 


7 


098 


062 


b 


013 


00D 


CR 


056 


038 


8 


099 


063 


c 


014 


00E 


SO 


057 


039 


9 


100 


064 


d 


015 


OOF 


SI 


058 


03A 


I 


101 


065 


e 


016 


010 


DLE 


059 


03B 


r 


102 


066 


f 


017 


011 


DC1 


060 


03C 


< 


103 


067 


g 


018 


012 


DC 2 


061 


03D 


= 


104 


068 


h 


019 


013 


DC3 


062 


03E 


> 


105 


069 


i 


020 


014 


DC 4 


063 


03F 


? 


106 


06A 


J 


021 


015 


NAK 


064 


040 


@ 


107 


06B 


k 


022 


016 


SYN 


065 


041 


A 


108 


06C 


1 


023 


017 


ETB 


066 


042 


B 


109 


06D 


m 


024 


018 


CAN 


067 


043 


C 


110 


06E 


n 


025 


019 


EM 


068 


044 


D 


111 


06F 


o 


026 


01A 


SUB 


069 


045 


E 


112 


070 


P 


027 


01B 


ESCAPE 


070 


046 


F 


113 


071 


q 


028 


01C 


FS 


071 


047 


G 


114 


072 


r 


029 


01D 


GS 


072 


048 


H 


115 


073 


s 


030 


01E 


RS 


073 


049 


I 


116 


074 


t 


031 


OIF 


US 


074 


04A 


J 


117 


075 


u 


032 


020 


SPACE 


075 


04B 


K 


118 


076 


V 


033 


021 


; 


076 


04C 


L 


119 


077 


w 


034 


022 


\> 


077 


04D 


M 


120 


078 


X 


035 


023 


# 


078 


04E 


N 


121 


079 


y 


036 


024 


$ 


079 


04F 





122 


07A 


z 


037 


025 


% 


080 


050 


P 


123 


07B 


{ 


038 


026 


& 


081 


051 


Q 


124 


07C 


1 


039 


027 


\ 


082 


052 


R 


125 


07D 


} 


040 


028 


( 


083 


053 


S 


126 


07E 


- 


041 


029 


) 


084 


054 


T 


127 


07F 


DEL 


042 


02A 


* 


085 


055 


U 









CR=Carriage Return 



I 



APPENDIX B 



RAE I/O LINKAGES 



The following describes user I/O linkages and page (zero) vectors. Functions 
described include CRT, keyboard, break key, printer, CONTROL Y, and user. Page 
(zero) locations $EC - $F7 are reserved for future RAE extensions. 

BREAK KEY RAE vectors thru INSVEC ($A666) in system RAM for testing for the 
break key being depressed. This 3-byte location contains a JMP 
instruction. If you wish to substitute another routine to detect if 
the break key is depressed, change the 2-byte address part of the JMP 
instruction to point to the alternate break key processing routine. 

CONTROL Y When a CONTROL Y ( A Y) is entered, RAE "JUMPS" to location $0000 for 
execution of user supplied instructions. RAE does not enter any 
default code at this location. The user supplied routine can reenter 
RAE via a JMP to the warm start address ($B003) . None of the 
registers need be preserved. 

CRT RAE vectors thru OUTVEC ($A663) in system RAM for outputting to the 
CRT. This 3-byte location contains a JMP instruction. If you wish to 
redirect output to another device such as a printer, change the 2- 
byte address part of the JMP instruction to point to the alternate 
devices software driver. 

KEYBOARD RAE vectors thru INVEC ($A660) in system RAM for inputting from the 
keyboard. This 3-byte location contains a JMP instruction. If you 
wish to redirect output to another device such as a TTY, change the 
2-byte address part of the JMP instruction to point to the alternate 
devices software driver. 

PRINTER RAE reserves 3-bytes starting at $00B6 which the user can use to 
vector to a routine which drives an alternate output device. On cold 
start, RAE enters an RTS at this vector. When an >HA SET command is 
initiated, program control is transferred thru this vector for 
driving an alternate output device while outputting to the CRT at the 
same time. Register A will contain the ASCII character to be output. 
Registers X and Y should be preserved and the decimal mode bit in the 
PSR should be left cleared. Outputting thru this vector is terminated 
via >HA CLEAR. 

USER When a user command is entered, RAE "JUMPS" to location $0003 for 
execution of user supplied instructions. RAE does not enter any 
default code at this location. The user supplied routine can reenter 
RAE via a JMP to the warm start address ($B003) . None of the 
registers need be preserved. 



APPENDIX C 

CONVERTING MOS TECHNOLOGY/ SYSTEM 65 
ASSEMBLY LANGUAGE PROGRAMS TO RAE 



This table shows by example, how to translate from MOS Technology/System 65 
syntax to RAE syntax. 



LINE 




MOS TECHNOLOGY 






NO. 




SYSTEM 65 




RAE 


.0006 




* = $A600 




.BA $A600 


.0007 


SCPBUF 


* = *+$20 


SCPBUF 


.DS $20 


.0008 


RAM 


= * 


RAM 


.DI = ;or just RAM 


.0024 


RC 


= SCRD 


RC 


.DI SCRD 


:00"87 


PADA 


= $A400 


PADA 


.DE $A400 


.0252 




BYT $FF,$FF,$FF 




.BY $FF $FF $FF 


.0430 




BNE *+5 




.BNE = +5 


.0434 




STX $FF 




STX *$FF 


.1589 


ASCMI 


= *-l 


ASCMI 


.DI = -1 


.1711 


STDVAL 


.DBY $D54C,$2410 


STDVAL 


BY $D5 $4C 


.1723 




.WORD $C000 




.SE $C000 


.1724 




.WORD TTY 




.SI TTY 


.1778 




.END 

.LDA #>EXPRESSION 

.LDA #<EXPRESSION 




.EN 

LDA #H, EXPRESSION 

LDA #L, EXPRESSION 



1. The following RAE directives do not have equivalent functions in the MOS 
Technology/System 65 assembler: 

.LS, .LC, .OS, .OC, .RC, .MD, .ME, .EC, .ES, .RS 

2. The following RAE directives have similar functions in the System 65 
assembler: 

.CE is an intrinsic attribute of the System 65 assembler. 

.EJ is ".PAG" in the System 65 assembler. 

-MC is implemented in a constrained fashion on System 65 i.e., the 

"entire" object program may be assembled into a different memory 
space than the one specified for execution. 

•CT is available on System 65 for source stored in multiple disk files 
via the FILE directive. 



APPEDIX D 



0010 

0020 ■■ 

0030 

0040 

0050 

0060 

0070 

0080 

0090 

0100 

0110 

0120 

0130 

0140 

0150 

0160 

0170 

0180 

0190 

0200 

0210 

0220 

0230 

0240 

0250 

0260 

0270 

0280 

0290 

0300 

0310 

0320 

0330 

0340 

0350 

0360 

0370 

0380 

0390 

0400 

0410 

0420 

0430 

0440 

0450 

0460 

0470 

0480 

0490 

0500 

0510 

0520 

0530 

0540 

0550 



****RELOCATING LOADER FOR SYNERTEK SYSTEMS RAE-1 



.OS 



;***COPYRIGHT 197 9 BY SYNERTEK SYSTEMS CORP.*** 
;*** ALL RIGHTS RESERVED. *** 



;++++++ USER INPUTTED VARIABLES BEFORE EXECUTION ++++++ 
FILE/NO .DE $0110 ; FILE NUMBER (0-99) 
OFFSET '.DE $E0 ;RELOCATOR OFFSET (2 BYTES) 
BUFFER .DE $C8 ;ADDRS. OF R.L. BUFFER 



RELOCATOR DIRECTIVES 



DIRECTIVE 
OF 

IF 
2F 
3F 
4F 
5F 

6F 
7F 



DESCRIPTION 

EXTERNAL 2 BYTE ADDRS . PRECEEDS 
DON'T RELOCATE. OTHERWISE RELOCATE. 

#L, DATA PRECEEDS 

#H, DATA PRECEEDS, LO PART FOLLOWS. 

.AS OR .HS BYTE FOLLOWS. 

.SE OR .SI 2 BYTE ADDRS. FOLLOWS. 

TURN RELOCATOR ON (VIA .RS). 
RESOLVE ADDRESSES AND RELOCATE CODE 

TURN RELOCATOR OFF (VIA .RC) . 
RESOLVE ADDRESSES BUT DO NOT 
RELOCATE CODE 

. DS - 2 BYTE BLOCK VALUE FMLLMUS, 



.BA $0200 

;TAPE INPUT PARMS 
LORD/NO .DE $0180 
TSTART .DE $A64C 
TEND .BE $A64A 



0: NO STORE; 1: STORE 
LOAD BEGINNING AT TSTART 
STOP LOADING AT TEND 



HEADER INPUT DATA 
HFILE/NO .DE $017A HEADER FILE NUMBER 
HSTART . DE $017B HEADER START 



0200- A2 FF 

0202- 9A 

0203- E8 

0204- 20 86 8B 

0207- D8 

0208- 8E 21 01 
020B- 20 E6 02 
020E- 4C 14 02 
0211- 20 74 03 



0214- 

0216- 

0218- 

021B- 

021D- 

021F- 

0222- 

0224- 

0227- 

022A 

022C- 

022E- 

0231- 

0233- 

0235- 

0237- 



C9 7F 
DO 03 
4C AA 03 
C9 3F 
DO OB 
20 74 03 
81 DC 
20 88 03 
4C 11 02 
C9 4F 
DO 03 
4C AD 02 
C9 5F 
DO 04 
A2 00 
FO D8 



0239- C9 6F 
023B- DO 04 
023D- A2 02 
023F- DO DO 
0241- 81 DC 
0243- 20 88 03 
0246- C9 00 
0248- FO C7 
024A- C9 20 
024C- FO 5F 
024E- 8D 21 01 
0251- 29 9F 



0560 

0570 

0580 

0590 

0600 

0610 

0620 

0630 

0640 

0650 

0660 

0670 

0680 

0690 

0700 

0710 

0720 

0730 

0740 

0750 

0760 

0770 

0780 

0790 

0800 

0810 

0820 

0830 

0840 

0850 

0860 

0870 

0880 

0890 

0900 

0910 

0920 

0930 

0940 

0950 

0960 

0970 

0980 

0990 

1000 

1010 

1020 

1030 

1040 

1050 

1060 

1070 

1080 

1090 

1100 

1110 

1120 



HEND 



VARIABLES 
SCRAT 
TEMPI 
TEMP2 
SAVE 
ADDRS 
BUFF. END 



,DE $017D HEADER END 



.DE $11E SCRATCH AREA 

.DE $11F SCRATCH AREA 

.BE $120 SCRATCH AREA 

.BE $121 SCRATCH AREA 

.DE $DC 4 BYTES OF ADDRESS INFO. 

.DE $0123 END OF 256 BYTE BUFFER 



BUFF. INDEX . DE $0124 PRESENT ACCESSED DATA FROM BUFFER 



R(X)=00: 
R(X)=02: 



RELOCATOR ON 
RELOCATOR OFF 



BEGIN EXECUTION AT LABEL START 



START 



LOOP1 

f 

ENTY 
PRO.SF 



OP<CKG 



W: 



CKNX 



NO<REL 



TXS 


INITIALIZE STACK 


I NX 


R(X)=00: SET RELOCATOR INITIALLY TO 


JSR 


ACCESS 


CLD 




STX 


SAVE R{X)=00 


JSR 


LOAD<BUFF 


JMP 


ENTY 


JSR 


GET<DATA 


CMP 


#$7F ;CKG. FOR . DS 


BNE 


PRO.SF 


JMP 


PR0.7F ;JUMTO PROCESS DIR. 7F 


CMP 


#$3F CKG. FOR RELOCATOR DIRECTIVE 


BNE 


OP<CKG 


JSR 


GET<DATA 


STA 


(ADDRS, X) 


JSR 


INC<ADDRS 


JMP 


LOO PI 


CMP 


#$4F CKG. FOR .SE, .SI 


BNE 


W: 


JMP 


TWO<BYT<AD 


CMP 


#$5F CKG. FOR RELOCATOR ON 


BNE 


CKNX 


LDX 


#$00 


BEQ 


LOOP1 


CMP 


#$6F CKG. FOR RELOCATOR OFF 


BNE 


NO<REL 


LDX 


#$02 


BNE 


LOOP1 


STA 


(ADDRS, X) STORE OP CODE 


JSR 


INC<ADDRS 


CMP 


#$00 CKG. 


BEQ 


LOOP1 


CMP 


#$20 0KG. FOR JSR INSTR. 


BEQ 


TWO<BYT<AD 


STA 


SAVE SAVE R(A), IT CONTAINS OP CODE 


AND 


#$9F 






0253- F0 BC 
0255- AD 21 01 
0258- 29 ID 
025A- C9 08 
025C- FO B3 
025E- C9 18 
0260- FO AF 



0262- AD 21 01 
0265- 29 1C 
0267- C9 1C 
0269- FO 42 
026B- C9 18 
026D- FO 3E 
026F- C9 OC 
0271- FO 3A 



0273- 20 74 03 
0276- 81 DC 
0278- 20 88 03 
027B- 20 74 03 
027E- C9 2F 
0280- FO 14 



0282- 
0284- 



C9 IF 
DO BE 



0286 

0289 

028A 

028C 

028E 

0290- 20 

0293 



20 95 03 
10 

Al DC 
65 EO 
81 DC 

03 
4C 11 02 



0296- 20 74 
0299- 18 
029A- 65 EO 
029C- 08 



03 



029D- 
02A0- 
02A1- 



20 95 03 

28 

Al DC 



02A3- 65 El 



02A5- 
02A7- 
02AA- 



81 DC 
20 88 03 
4C 11 02 



02 AD- AO 82 



1130 

1140 ■ 

1150 

1160 •" 

1170 

1180 

1190 

1200 

1210 

1220 

1230 

1240 

1250 

1260 

1270 

1280 

1290 

1300 

1310 

1320 

1330 

1340 

1350 

1360 

1370 

1380 

1390 

1400 

1410 

1420 

1430 

1440 

1450 

1460 

1470 

1480 

1490 

1500 

1510 

1520 

1530 

1540 

1550 

1560 

1570 

1580 

1590 

1600 

1610 

1620 

1630 

1640 

1650 

1660 

1670 

1680 

1690 



BEQ L0QP1' 

LDA SAVE RESTORE OP CODE 

AND #$1D 

CMP #$08 CKG. FOR ONE BYTE INSTR. 

BEQ LOOP1 

CMP #$18 CKG. FOR ONE BYTE INSTR. 

BEQ LOOP1 

t 

;NOW, TEST FOR INSTR. CONTAINING 2 BYTES 
;OF ADDRESS INFORMATION 

f 

LDA SAVE RESTORE OP CODE 

AND #$1C 

CMP #$1C 

BEQ TWO<BYT<AD 

CMP #$18 

BEQ TWO<BYT<AD 

CMP #$0C 

BEQ TWO<BYT<AD 

THE REMAINING CONTAIN ONE BYTE OF 
ADDRESS INFORMATION 

PROCESSING OF ONE BYTE ADDRESSES AND IMMEDIATE DATA 



ONE<BYT<AD JSR 
STA 
JSR 
JSR 
CMP 
BEQ 
CMP 
BNE 



; PROCESS 
IMM<LO 



#L, 
JSR 
CLC 
LDA 
ADC 
STA 
JSR 
BACK<TO<Ll JMP 



GET<DATA 
(ADDRS,X) 
INC<ADDRS 
GET < DATA 

#$2F CKG. FOR RELOCATOR DIRECTIVE 
IMM<HI CKG. FOR #H, 

#$1F CKG. FOR RELOCATOR DIRECTIVE 
ENTY 

DATA FOR RELOCATION 
DEC<ADDRS 



(ADDRS,X) 

*OFFSET+00 ADD OFFSET LOW PART FOR #L 

(ADDRS,X) 

IMC<ADDRS 

LOOP1 

/PROCESS #H, DATA FOR RELOCATION 
IMM<HI JSR GET<DATA LOW BYTE FOLLOWS REL. DIR. 



CLC 
ADC 
PHP 
JSR 
PLP 
LDA 
ADC 
STA 
JSR 
JMP 



*OFFSET FROM THE LO ADDRS . PART 

DEC<ADDRS 

(ADDRS, X) 

*OFFSET+$l NOW FORM THE EFFECTIVE #H, 

(ADDRS, X) 

INC<ADDRS 

LOOP1 



/PROCESSING OF TWO BYTE ADDRESSES 
TWO<BYT<AD LDY #$02 



02AF- 98 
02B0- 48 
0281- 20 74 



03 



0284- 81 DC 
02B6- 20 88 03 
02B9- 68 
02BA- A8 
02BB- 88 
02BC- DO Fl 
02BE- 20 74 03 
02C1- C9 OF 
02C3- DO 03 
02C5- 4C 11 02 
02C8- 48 
02C9- 20 95 03 
02CC- 20 95 83 



02CF- Al DC 
02D1- 18 
02D2- 65 EO 
02D4- 81 DC 
02D6- 20 88 03 
02D9- Al DC 
02DB- 65 El 
02DD- 81 DC 
2DDF- 20 88 03 
02E2- 68 
02E3- 4C 14 02 



02E6- A9 7A 
02E8- 88 4C A6 
02EB- A9 7F 
02ED- 88 4A AB 
02F0- A9 01 
02F2- 8D 4D A6 
02F5- 8D 4B A6 
02F8- 8D 80 01 
02FB- 20 D5 03 



02FE- DO 4D 
0300- A2 00 

0302- AD 78 01 

0305- 3B 

0306- ED 7B 01 



0309- 8D 23 01 



1700 

1710 

1720 

1730 : 

1740 

1750 

1760 

1770 

1780 

1790 

1800 

1810 

1820 

1830 

1840 

1850 

1860 

1870 

1880 

1890 

1900 

1910 

1920 

1930 

1940 

1950 

1960 

1970 

1980 

1990 

2000 

2010 

2020 

2030 

2040 

2050 

2060 

2070 

2080 

2090 

2100 

2110 

2120 

2130 

2140 

2150 

2160 

2170 

2180 

2190 

2200 

2210 

2220 

2230 

2240 

2250 

2260 



XX 



XY 



TYA 

PHA SAVE R(Y) 

JSR GET<DATA 

STA (ADDRS,X) 

JSR INC<ADDRS 

PLA 

TAY RESTORE R(Y) 

DEY 

BNE XX 

JSR GET<DATA 

CMP #$0F CKG. FOR RELOCATOR DIRECTIVE 

BNE XY 

JMP LOOP1 

PHA 

JSR DEC<ADDRS 

JSR DEC<ADDRS 



/DECREMENT BACK TO ADDRESS START 



LDA 
CLC 
ADC 
STA 
JSR 
LDA 
ADC 
STA 
JSR 
PLA 
JMP 



(ADDRS,X) 

*OFFSET AND OFFSET LO 

(ADDRS,X) 

INC<ADDRS 

(ADDRS,X) 

*OFFSET+$l ADD OFFSET HI 

(ADDRS,X) 

INC<ADDRS 

ENTY 



SUBROUTINE LOAD BUFFER WITH DATA FROM TAPE 

LOAD<BUFF LDA #$7 A ADDLO OF START OF HEADER 

STA TSTART+$00 

LDA #$7F ADDLO OF END OF HEADER 

STA TEND+$00 

LDA #$01 HI ADDRS 

STA TSTART+$01 

STA TEND+$01 

STA LOAD/NO 01: INDICATE TO LOAD 

JSR USER/LOAD USER LDA A BD FROM TAPE ROUTINE 

;THE ABOVE SETS UP AND LOADS HEADER INFORMATION 
;FROM TAPE. THE HEADER CONTAINS THE MODULE FILE 
; NUMBER, AND STARTING AND ENDING ADDRESSES OF 
/FOLLOWING DATA. 



BNE ERROR IF Z-BIT FALSE, ERROR IN LOADING 

LDX #$00 

LDA HEND+$00 
SEC 

SBC HSTART+$00 
/CALCULATE NUMBER OF BYTES IN FOLLOWING DATA 

/ 

STA BUFF. END INITIALIZE BUFFER END 



030C- AD 
030F- ED 
0312- DO 
0314- A5 
0316- 8D 

0319- 18 
031A- 6D 
031D- BD 

0320- A5 
0322- 8D 
0325- 69 
0327- 8D 



7E 01 
7C 01 
39 
C8 
4C A6 

23 01 
4A A6 
C9 

4D A6 
00 
4B A6 



032A-.AD 10 01 

032D- FO 08 

032F- CD 7A 01 

TARE 

0332- FO 03 

0334- 8E 80 01 

0337- 20 D5 03 



033A- DO 11 
033C- A2 00 
033E- AD 7A 01 
0341- C9 EE 
0343- DO OC 
0345- A9 00 

0347- 00 

0348- EA 

0349- EA 
034A- 4C 00 02 
034D- A9 EE 
034F- DO F6 



0351- AD 80 01 
0354- FO 90 
0356- AE 21 01 

0359- AO 00 
035B- Bl C8 
035D- 85 DE 
035F- C8 

0360- Bl C8 
0362- 85 DF 
0364- 8C 24 01 



0367- A5 DE 
0369- 18 



2270 

2280 

2290 

2300 • 

2310 

2320 

2330 

2340 

2350 

2360 

2370 

2380 

2390 

2400 

2410 

2420 

2430 

2440 

2450 
2460 

2470 
2480 
2490 
2500 
2510 
2520 
2530 
2540 
2550 
2560 
2570 
2580 
2590 
2600 
2610 
2620 
2630 
2640 
2650 
2660 
2670 
2680 
2690 
2700 
2710 
2720 
2730 
2740 
2750 
2760 
2770 
2780 
2790 
2800 
2810 
2820 



;NOW THE 



LDA HEND+'$01 POINTER 

SBC HSTART+$01 

BNE ERROR ONLY 256 BYTE BUFFER ALLOWED 

LDA *BUFFER 

STA T START 
CLC 

ADC BUFF. END # BYTES 

STA TEND 

LDA *BUFFER+01 

STA TSTART+$01 

ADC #$00 

STA TEND+$D1 
START AND END ADDRESS PARMS HAVE BEEN 



;SET UP TO LOAD FROM TARE INTO THE BUFFER. 

f 

LDA FILE/NO USER ENTERED FILE NUMBER 
BEQ STORE. DATA IF Ft = 00 . LOAD ANYWAY 
CMP HFILE/NO CMP WITH USER VERSUS THAT ON 



BEQ 
STX 

STORE. DATA JSR 



STORE . DATA 
LOAD/NO R{ X 
USER/LOAD 



)=0; NO STORE 



;THE ABOVE LOADS IN DATA INTO BUFFER DEPENDING 
;ON THE STATE OF LOAD/NO 



ERROR 



BNE 
LDX 
LDA 
CMP 
BNE 
LDA 
BRK 
NOP 
NOP 
JMP 
LDA 
BNE 



ERROR Z-BIT = FALSE THEN ERROR 

#$00 

HFILE/NO 

#$EE COMPARE IF END OF FILE 

BUFFLOADED 

#$00 INDICATE GOOD LOAD 



START 

#$EE INDICATE ERROR IN LOAD 

B 



;NOW GET ADDRS . INFO AND PUT IN ADDRS+$2, +$3 
;ADDRS. INFO IS IN FIRST TWO BYTES OF BUFFER 



BUFFLORDED 



LDA 
BEQ 
LDX 
LDY 
LDA 
STA 
INY 
LDA 
STA 
STY 



LOAD/NO CKG. 
LOAD<BUFF 
SAVE RESTORE 
#$0 

(BUFFER) ,Y 
*ADDRS+$2 



IF PROPER DRTR 



R(X) 



(BUFFER) ,Y 
*ADDRS+$3 
BUFF. INDEX 



SET BUFFER DATA POINTER 



;SET RELOCATION ADDRS. IN ADDRS+$0, +$1 
LDA *ADDRS+$2 
CLC 



036A- 65 EO 
036C- 85 DC 
036E- A5 El 
8370- 65 DF 
0372- 85 DD 

0374- 8E 21 01 
0377- EE 24 01 
037A- AC 24 01 
037D- CC 23 01 
0380- 90 03 
0382- 4C E6 02 
0385- Bl C8 
0387- 60 



0388- E6 DC 
038A- DO 02 
038C- E6 DD 
038E- E6 DE 
0390- DO 02 
0392- E6 DF 
0394- 60 



0395- 


C6 


DC 


0397- 


A5 


DC 


0399- 


C9 


FF 


039B- 


DO 


02 


039D- 


C6 


DD 


039F- 


C6 


DE 


03A1- 


A5 


DE 


03A3- 


C9 


FF 


03A5- 


DO 


02 


03A7- 


C6 


DF 


03A9- 


60 





03AA- 20 74 03 
03 AD- 48 
03AE- 20 74 03 
03B1- A8 
03B2- AD 24 01 
03B5- C9 05 
03B7- 90 18 
03B9- 18 
03BA- 68 
03BB- 48 
03BC- 65 DC 
03BE- 85 DC 
03C0- 98 



2830 

2840 

2850 

2860 . 

2870 

2880 

2890 

2900 

2910 

2920 

2930 

2940 

2950 

2960 

2970 

2980 

2990 

3000 

3010 

3020 

3030 

3040 

3050 

3080 

3070 

3080 

3090 

3100 

3110 

3120 

3130 

3140 

3150 

3160 

3170 

3180 

3190 

3200 

3210 

3220 

3230 

3240 

3250 

3260 

3270 

3280 

3290 

3300 

3310 

3320 

3330 

3340 

3350 

3360 

3370 

3380 

3390 



GET<DATA 



WX 



ADC *OFFSET 

STA *ADDRS 

LDA *OFFSET+$l 

ADC *ADDRS+$3 

STA *ADDRS+$1 

STX SAVE X IN CASE WE BR. TO LOAD/BUFF 

INC BUFF. INDEX INC. 256 BYTE BUFFER POINTER 

LDY BUFF. INDEX 

CPY BUFF. END 

BCC WX BR. IF NOT AT END OF DATA IN BUFFER 

JMP LOAD<BUFF RELOAD BUFFER 

LDA ( BUFFER ),Y 

RTS 



INCREMENT ADDRS+$0, +$1 AND ADDRS+$2, +$3 
INC<ADDRS 



SKIP<INC1 



SKIP<INC2 



INC 
BNE 
INC 
INC 
BNE 
INC 
RTS 



*ADDRS 

SKIP<INC1 

*ADDRS+$1 

*ADDRS+$2 

SKIP<INC2 

*ADDRS+$3 



DECREMENT ADDRS+$0, +1 AND ADDRS+$2, +$3 
DEC<ADDRS 



SKIP<DEC1 

SKIP<DEC2 

7F LO HI 
PR0.7F 



DEC 
LDA 
CMP 
ONE 
DEC 
DEC 
LDA 
CMP 
BNE 
DEC 
RTS 



*ADDRS 

*ADDRS 

#$FF 

SKIP<DEC1 

*ADDRS+$1 

*ADDRS+$2 

*ADDRS+$2 

#$FF 

SKIP<DEC2 

*ADDRS+$3 



— PCL PCH 7F LO HI 



PROC . DS 



JSR 

PHA 
JSR 
TAY 
LDA 
CMP 
BCC 
CLC 
PLA 
PHA 
ADC 
STA 
TYA 



GET<DATA 

;SAVE LO 
GET<DATA 

;SAVE HI IN R(Y) 
BUFF. INDEX 
#$05 ;NO PROC. 
NO. PROC 

;GET LO 

*ADDRS 
*ADDRS 
;GET HI 



IF <= 4 



03C1- 65 DD 
03C3- 85 DD 
03C5- 68 
03C8- 48 
03C7- 18 
03C8- 65 DE 
03CA- 85 DE 
03CC- 98 
03CD- 65 DF 
03CF- 85 DF 
03D1- 68 
03D2- 4C 11 02 



03D5 

03D8- 

03DA- 

03DD- 

03DF- 

03E1- 

03E3- 

03E6- 

03E9- 

03EC- 

03EF- 

03F0- 

03F2- 

03F4- 

03F6- 



20 88 81 
A9 FF 
85 4E A6 
A0 80 
84 FD 
A9 09 
20 A5 89 
20 2E 83 
20 9C 82 
20 7B 8C 
D8 

A9 00 
90 02 
A9 01 
4C B8 81 



3400 
3410 
3420 
3430 
3440 
3450 
3480 
3470 
3480 
3490 
3500 
3510 
3520 
3530 
3540 
3550 
3560 
3570 
3580 
3590 
3600 
3610 
3620 
3630 
3640 
3650 
3650 
3670 
3680 
3690 
3700 
3710 
3720 
3730 
3740 
3750 
3760 
3770 
3780 
3790 
3800 
3810 
3820 
3830 
3840 
3850 
3860 
3870 
3880 
3890 



NO PROC 



ADC 
STA 
PLA 
PHA 
CLC 
ADC 
STA 
TYA 
ADC 
STA 
PLA 
JMP 



*ADDR'S+1 
*ADDRS+1 

;GET LO 

*ADDRS+2 
*ADDRS+2 
;GET HI 
*ADDRS+3 
*ADDRS+3 

LOOP1 



« SYSTEM MONITOR CASSETTE INTERFACE 1 ' 



DEFINITIONS: 



SAVER 

ACCESS 

ID 

MODE 

CONFIG 

ZERCK 

P2SCR 

LOADT 

MACCESS 

RESXAF 



USER/LOAD 



.DE 
.DE 
.DE 
.DE 
.DE 
.DE 
.DE 
.DE 
.DE 
-DE 



$8188 

$8B86 

$A64E 

$FD 

$8 9A5 

$832E 

$829C 

$8C78 

$8B9C 

$81B8 



JSR 
LDA 
STA 
LDY 
STY 
LDA 
JSR 



SKPERRU/L 



END. PGM 



SAVER 

#$FF 

ID 

#$80 

*MODE 

#$09 

CONFIG 
JSR* ZERCK 
JSR P2SCR 
JSR LOADT+$3 
CLD 
LDA 
BCC 
LDA 
JMP 



.EN 



:SAVE REGISTERS 
:ID=FF FOR USER RANGE 



rBIT 7=1 FOR H.S. 



#$00 ; 
SKPERRU/L 
#$01 ; 



r ENTRY IN TAPE LOAD 



Z-BIT = T 



Z-BIT = F 



RESXAF ; RESTORE REGS. EXCEPT A.PSR 



LABEL FILE: [ / 



EXTERNAL 



/FILE/NO=0110 

/LOAD/NO=0180 

/HFILE/NO=017A 

/SCRAT=011E 

/SAVE=0121 

/BUFF.INDEX=0124 

ENTY=0214 

W:=0231 

ONE<BYT<AD=0273 

IMM<HI=0296 

XY=02C8 

B=0347 

GET<DATA=0374 

SKIP<INC1=038E 

SKIP<DEC1=039F 

PROC.DS=03B9 

/ACCESS=8B86 

/CONFIG=8 9A5 

/LOADT=8C78 

USER/LOAD=03D5 



/OFFSET=00E0 

/TSTART=A64C 

/HSTART=017B 

/TEMP1=011F 

/ADDRS=OODC 

START=0200 

PRO.SF=021B 

CKNX=0239 

IMM<LO=028 6 

TW0<BYT<AD=02AD 

LOAD<BUFF=02E6 

ERROR=034D 

WX=0385 

SKIP<INC2=0394 

SKIP<DEC2=03A9 

NO.PROC=03D1 

/ID=A64E 

/ZERCK=832E 

/NACCESS=8B9C 

SKPERRU/L=03F6 



/BUFFER=00C8 

/TEND=A64A 

/HEND=017D 

/TEMP2=0120 

/BUFF.END=0123 

LOOP1=0211 

OP<CKG=022A 

NO<REL=0241 

BACK<TO<L1=0293 

XX=02AF 

STORE. DATA=0337 

BUFFLOADED=0351 

IMC<ADDRS=0388 

DEC<ADDRS=0395 

PRO.7F=03AA 

/SAVER=8188 

/MODE=00FD 

/P2SCR=829C 

/RESXAF=81B8 

END.PGM=03F9 



//0000,03F9,03F9 



APPENDIX E 

The GoertzWorks ! Ram Model 

Synertek Systems released RAE-1 in 1979. At that time mass storage devices, 
large memory arrays, CRT based I/O devices, and fast modems were not within 
reach to the home user. This becomes obvious while reading the users manual. It 
discusses assembling to cassette tape (no large memory arrays) and how to attach 
a TTY (no CRT based I/O) . RAE-1 was, and still is, a very powerful editor / 
assembler combination. The GoertzWorks! Ram model helps get around these 
limitations. 

The GoertzWorks! Ram model consists of the following: 

'RAE-1 in its entirety. However, it is loaded into ram via floppy. There 
are no ROMs. It still occupies $B00O-$BFFF and $E000-$EFFF. 

Boot executives to automatically modify the SET limits to: 

Text file: $1000-$7FFC 

Label file: $D000-$DFFC 

Object file reserve: $0200-$0FFF 

RELOCATABLE buffer Not needed but can be located anywhere free 

Attachments to load and save source and object files to floppy. 

9600 baud on a lmhz system. * 

Two full handshake RS-232 I/O ports with the ability to input and output 
to both ports at the same time. 

Modem support . 

Real time disassembling debugger. 

RAE-1 formatted disassembler. 

Standard hex dump. 

Some of the above require modifications to the SYM-1 hardware but are minor. 

The SYM-1 the GoettzWorks! Ram model runs on contains only the SUPERMON and 
SYMDOS ROMs. The remaining address space is occupied completely with ram. 

These additions make RAE-1 very usable, even in today's "WINTEL" world. It is 
rally nice to be able to edit / assemble / debug / run on the same machine - no 
need to transfer object code from a WINTEL system. 

I have found nothing to replace it. 

Leland Goertz 
kd6mzu@attitude . com 



APPENDIX F 
SOFTWARE LISTING 



Enter range limits for hex dump: BOOO-BFFF 
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AD 
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B170 


Bl 


4C 


60 


BO 


A5 


C8 


8D 


29 


01 


18 


6D 


22 


01 


8D 


2B 


01, FE 


1L - 0%H ) m" + 


B180 


A5 


C9 


8D 


2A 


01 


69 


00 


8D 


2C 


01 


8E 


22 


01 


20 


8F 


E3,8A 


%I * i , " c 


B190 


84 


CE 


20 


7C 


E5 


A4 


CE 


20 


9D 


E3 


60 


8E 


10 


01 


20 


A0,2E 


N |e$N c" 


B1A0 


B6 


C9 
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OA 
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OA 
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B3 


AO 


02 


Bl 


DD 


DO 


Dl 


20 


EF 


Bl 


20 


CA 


E3 


60 


86, B9 


$3 1]PQ ol Jc' 


B1F0 


E3 
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B220 
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B310 


FO 03 4C 3E B4 A8 68 CD 02 01 BO F6 48 98 85 D4,98 


p L>4 (hM OvH T 


B320 
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Memory block $EOOO-$EFFF checksum: B20A 



APPENDIX H 

SOFTWARE LISTING 

Enter range limits for raw ASCII dump: B000-BFFF 

4CEDBF4CAEB00CE6B4E8BBE82DEC4DB4AFE3A2FF9AE88 6EE8 6EF8E130186E38E1F 

018E53A620EBE5AD02A009808D02A0A9018D20018D21018D0F0185DB8E0C018E0D 

018E0E01A047201EB5A90B85EA20F7EA2096B08E2801200FE32018E3A200D8208 6 

8BA9008D53A68D13018D330120CAE3A2FF8E12018E11019AE88E14018E15012064 

B2A0002002B5C050B0E420AEB6A2ED4C4DB4AD000185D3AD010185D48AA00291D3 

60A9808D53A600EAEA20F7EA4C5EBOA20C20E6B24C60B0204 9E44C5EB020AOB68D 

0F01C943D0038E0F0120FFB4C050B0138E1101A9018D1301204AE2E6D1A5D1291F 

85EA4C60B020AOB68DOE01C943D0038EOE014C60B08E14018E130198482037BF20 

5FE08E110168A88E170120A0B6C94EF007C94CD006EE170120FFB420FCB1AD0801 

8D2F01AD09018D30014CC7BBA9018E11018D1301204AE220FFB42049B14C60B04C 

EBEFB93501C92FD018A9FF8D09012014B2AD1C0185DDAD1D0185DE20CBB14C60B0 

20FCB120B5B14C60B0A5C88D290118 6D22018D2B01A5C98D2A0169008D2C018E22 

01208FE384CE207CE5A4CE209DE3608E100120A0B6C94 6D00FC8A20A20E6B2AD0A 

018D10012002B560F0109012A00288300DB90A01D1DDFOF6B00420E8B16020B2B3 

AD0E01D0062032B620D9E320A8B520CAE320A4B3A002B1DDD0D120EFB120CAE360 

86E3A92F20A4E3A92F20A4E360A20820E6B2C0509007A9FF8D0B01D0082002B5A2 

0A20E6B220BFB4A002B1DDD00218608830FBB1DDD90801F0F6900160A5DD8D1C01 

A5DE8D1D0120A4B34C17B284CEAC220191C8EE2201A4CE60AD13011008A94FEE11 

012070BE4C11BEA002B1DD60EE13014CB8BB20BBB5A000B93501C9309004C93A90 

0160A2082042B684E1AD1A0138E5E18D1A012064B3A4E12002B5C050B005A4E120 

FCB220F1B2F027AD080118F8 6D0C018D0801AD09016D0D018D0901D82035B620BB 

B5A00084E120C5B2D0C620CAE34C72B0A0002002B5B93501C92FD003D936016020 ,? 

42B6C050B009A5DFF005A2004C44B4 6020D5B2A920D93501D0F06018AD0C016D0D | 

018D150160984820ADB4AD1A0138 65D34 88A65D4CD0301900EF0034C3EB4A8 68CD 

0201B0F6489885D46885D320B6B44C33B320E9B420E8B4A1DF81E1A5DDC5DFD0F0 

A5DEC5E0D0EAA000AD080191DDAD0901C891DD68AAC8BD3501E891DDCC1A01D0F4 

098091DDA20020A0B0602014B2D00160B0FD20A4B420A4B3A002B1DDD00FA5DF85 

D3A5E085D420A0B02014B260A1DD81DF20D7B420D6B488D0F3A1DD81DF0820D7B4 

20D6B42810F230CE20D7B420D7B4A1DD10F920D7B4 60202 6B6B1DD8D0801C8B1DD 

8D0901C8AD0F01F02DB1DDC93BF027C920F0032009B420F9B3A6EAC93BF0172009 

B420F9B3C93BFOOA2009B420F9B3C93BD0032002B42009B44CF3B3B1DDC8C920FO 

F98860E88A2907D0FA60E050B01BB1DD300EC909F01A9D3501C8E8C920D0EB6029 

7FC909F0039D35018AA8A2006868602002B4C8D0D4E8E8E8E8E8E8E8E8E8E8E8E8 

E8E8E8E8E8E8E8E8E8E8E8E88A48A20020B7E7AD130110068E13018D1201A5E385 

CF8 6E3A90720A4E32042BF20CAE3A92120A4E36820E2E39848A000201EB568A820 

32B6A92F20A4E3AD280120E2E320CAE3AD1201D005A5CF85E360A9FF85DB4C58B0 

A5DD85DFA5DE85E060A5D385DFA5D485E060A5D385E1A5D485E260AD000185DDAD 

010185DE60AD040185DDAD050185DE60E8E8E8E8E8E8E88AOAAAF6D3D002F6D4A2 

0060E8E8E8E8E8E8E88AOAAAD6D3B5D3C9FFD002D6D4A200602010B5B93501C8CO 

50B005C920FOF4 8860B93501C8C050B005C920DOF488 60B92AB5D0016020A4E3C8 

D0F4204154204C4 94E45000D0A0A0A4C4142454C204 64 94C4 53A20205B202F203D 

2045585445524E414C205D0D0A0A005245414 4 59204 64F52205041535320320D0A 

00504 1474520000DOA5241452056312E300DOA434F5059524 94748542031393739 

2053594E4 552544 54B2053595354454D53204 34F52502E200D0A0D0A00A2008A4 8 

BD350120A4E368AAE88810F2A2006086E3A93E20A4E32026B620BDE3C90DD008C8 

8C1A0120CAE360C908F009C97FD01EA95C20A4E3883008A9209935014CC5B520CA 

E3AD1501FOC72035B64CBDB5C918FOEE993501C909F010C8C04 6D005A90720A4E3 

C050B0B9D0B0984 820DCE3C8982907D0F768A8C84C0FB6A055A9209935018810FA 

C8 6020DCE3AD090120E2E3AD080120E2E360A9009D00019D010185DF85E0207EB6 

D003A200604 8A5DFF009AD1101F004A20068 60C89848A0041E00013E010188DOF7 



68A8681D00019D00014C4EB620AOB6C9309018C93A900FC9419010C947BOOC290F 
18 6909E6DF290FE6E060A90060B93501C9619006G97BB00229DF60A900F006A901 
D002A9FF85E184E2A4E2A5E1F00E1006BDC7B8D00D60BD41B8D007 60BD41B7D001 
608D1A0120AOB6CD1A0108 9838E5E2C8E828F022C901F005C902F002E8E8E8A5E1 
3005D0C24CBCB6BDC6B8290F8 6E03865E0AA4CBCB648A5E1D007 68C901D0A9F005 
68C902D0A2A5E1F00386D060BD41B785E1BD42B785E26868E085B00620FFB44C3C 
B72002B5A2006CE1004252A6B0434C52B0505524E54 64FC2B050524CB14155B4B0 
4153FCB05041B7E2525535B14D41ECB04F55A7BB4F4E50E34F4633E3484112E947 
45BCB04C4100BF45441CE64E55FDE3444590EA4 64916E64D4F87EA434F44E95345 
BDEA5553F7EF44554EEB454E84EB4C4F95EB4443A6EB002E53A6386E53A6600000 
00000000000000000000534 94 6BA42415ABA454E63BB4259C4BA534 54 FBA4 4 4 9FE 
BA4C533BBA4C4340BA4D439ABA4F4331BA4F532CBA434527BA435436BA525322BA 
44 4507BB524337E44453B0B9455341EE45434 6EE454A0BBA4D448DEE4D4533EF00 
0000000000000000000000000000000000000000000000004120CABD0029200ABE 
00544158AA544159A8545358BA5458418A5458539A54594198434C4318434C44D8 
434C4958434C56B853454338534 544F853454 9784E4F50EA52544 9405254536044 
4558CA444559884 94E58E84 94E59C85048414850485008504C4168504C50284252 
4B000042434390424353B0424551F0424D4 930424E45D042504C10425643504256 
537000524F52C5C16E7E66766A414443E8DA6D7D796575716169414E44E8DA2D3D 
39253531212941534CC5C10E1E06160A424 95482802C24 434D50E8DACDDDD9C5D5 
D1C1C94350588382ECE4E04350598382CCC4C0444543C4C0CEDEC6D6454F52E8DA 
4D5D59455551414 94 94E43C4C0EEFEE6F64A4D5092004C6C4C4441E8DAADBDB9A5 
B5B1A1A94C4458A5A2AEBEA6B6A24C4459C5C2ACBCA4B4A04C5352C4C14E5E4 656 
4A53528100204F5241E8DA0D1D190515110109524F4CC5C12E3E26362A534243E8 
DAEDFDF9E5F5F1E1E95354 41E7D88D9D998595918153545883A08E869653545983 
C08C84 94 00AD1701F00EAD1301C901D00720BFBEA90585E7204AE2AD1A01F0068C 
12014C4 9B4A5D11865D785D7A5D265D885D8A5D118 65D985D9A5D265DA85DAAD13 
011018A97FEE11012070BEA5D1EE11012070BEA5D2EE11012070BE4CFDBBAD1301 
F00F300DAD1701F008AD1F01F00320D1E84CFDBBA95F4C9BBD8E1201F0178C1601 
F0128E1601FOOD8C1401F0088C1701F0038E17014CFDBB204AE2EE1E014C4 9B220 
4AE2A2008E1E014C4 9B2A5DD48A5DE48204AE2AD1A01F0068C12014C4 9B4 6885DE 
6885DDA5D185D785D9A5D285D885DAAD3501C920F008AD1301D0032057BBAD1301 
100320EDBE4CFDBBAD1201488C1201204AE2688D1201A5D185D9A5D285DA4CFDBB 
204AE2A5D120EBBA2002B5C050B0D5900AC05090062043B44CFDBBC93BF0C5C927 
D0DDC8C050B0EDB93501C927D003C8D0D620EBBAB850EB48AD13011008A93FEE11 
012070BE682070BE60202FBB2057BB4CFDBB202FBBD01DA001C8B1CE10FBB1CEC8 
91CE8888C001D0F5C8A92F91CE20DBB4205FE02057BB4CFDBB204AE2AD3501C920 
D0062048B44CFDBBA000201AE1A5DD85CEA5DE85CFAD1301F0058E1E01A9FF60A0 
O0A5D191CEC8A5D291CE6O2O47BFA5BCD00AA5BFDOOAA5BBD0OAFO0DA221D006A2 
22D002A223204DB4AD1301F00E3006AD17014CFEBE20EDBE4C58B0EE1301AD1401 
F01C209DE3A02E201EB54C58B08E2201209BB18E1101A2FF8E13018EOA01AD2F01 
8D0801AD30018D09012014B2A2008 6E68 6DC8 6DBA2FF9AE88E16018 6C48 6C58 6C2 
8 6C38 6BB8 6BC8 6BF8 6C1A90085D785D9A90285D885DAAD1301101120FOBE4C08BC 
A2006885DD6885DE20A4B3A5DE48A5DD488E1E012059B2D054A5BBF005A227204D 
B4E6C4D009E6C5D005A22F204DB4AD1401D008A9018D12014C46B42047BF20CAE3 
20CAE320CAE3A5BA8D10012071E4A9008D1101AD2F018D0801AD30018D09012014 
B2F0CEA2FF9AE84C08BCA200AD1701F0152047BFAD1301C901D00BA5BCF004A5C1 
F00320CAE320B2B384E9E6E6A000B93501C93BF00320FFB48 6BDA5BBF008A22420 
4 4ED4CFDBBA5BFF008A2192044ED4CFDBBAOOOB93501C93BD0034CFDBBC920F008 
AD1301D003207 9BF20FFB4B93501C93BFOE7C050BOE3C92ED018C8B93701C920FO 
06204AB4 4CFDBBA28520AEB6A2004CE5BCB93801C920D05020B2B6F009BD41B820 
70BE4CFDBBA26520B2B6F034BD41B82070BE20FFB4AD1301F023204AE218A5D1E5 
D748A5D2E5D8D00B68C980900F204CB4 4CFDBBC9FFD0F668C98090F14C04BDA200 
20B6B6D0034C8BEC2002B5B93501C923D079A20B203DBEA255204 4EDC8B93501C9 
27D006B936014C04BDA200204AE2A5D14C04BD204AE2A5D12070BEAD1E01F026A9 
1FD00F204AE2A5D22070BEAD1E01F015A92F48AD1301101068EE1101482070BE68 



C92FF0074CFDBB684CFDBBA5D1EE11014C04BD2070BEAD1E01D0E9A90F4C9BBDA2 
0C203DBE4CFDBBA2F620AEB6AAB93501C92AD00AC820C1E0F03AA23FD01AC928D0 
0FC820C1E0A2FB20AEB6A234D009D00720C1E0F00CA24A2044EDAA4CC8BAE8E8E8 
E8203DBEA5D1207QBEA5D24CBDBDE8E8E8E8E8E8E8E8E8203DBEA5D12070BEA5D2 
F00AA200AD1301F003204DB44CFDBB8 6DDA6D0BDC8B885DEA90485DFBDC7B8C6DF 
30100A9001E8C6DDD0F4B012A2002042B4 60A5DE0A9001E8C6DDD0F890EEBDC8B8 
48A200AD1301F0573059AD1701F031A5BCF004A5C1F029A5E7D007A90585E720BF 
BEA5E7C90ED0092047BF20CAE34C8BBE20DCE3A5E718690385E7684 820E2E3AD16 
01F01A6881D920DAB420D9B460A5D820E2E3A5D720E2E3A92D20A4E36068B850E5 
68203CB2AD1101D00620DAB44CE5BECE1101AD2201C9FFB001602074B18E2201A5 
D7203CB2A5D8203CB260F0032062E220EFB1200FBF2019BF4C5EB0A5DC20E2E3A5 
DB4CE2E3A92C20A4E3A5D820E2E3A5D720E2E3A92C20A4E3A5DA20E2E3A5D94CE2 
E3AD040185D5AD050185D66098484C55BF9848AD1301C901D022AD1701F01DA5E6 
F019A4E7A5BCD013C820DCE3C01090F8A4E92035B620DCE320A8B586E768A88 6E6 
60A5D585B9A5D685BAA5BCF0122066E0D00218602076E0D0242089E04CA2BF2066 
E0D0192047BF207EE084E42094E0A6E420A0E020A0E020A0EO4CBCBF84E42094E0 
A6E4BD3501C940901D20AOEOBD3501C920F01DA5BCF007BD3501C929F012BD3501 
2054E290E3205FE0A2002041B438604C00E0A96085B6AD00A0297F8D00A04C12B0 
00000000 

Memory block $B000-$BFFF checksum: 672D 



APPENDIX I 

SOFTWARE LISTING 

Enter range limits for hex dump: EOOO-EFFF 

B1D5098091D538 98 65D585D5A2008A65D685D6CD0701F02EB033205FEOA4E4201A 

E1A5DE48A5DD4820A8E0205 9B2F00C6885DD6885DE2047B44C50E06885DD6885DE 

A4E41860A5D5CD060190CD203FB4A5B985D5A5BA85D6205FE0A4E438 60A900A002 

91D560B93501C921D008D93601D003D9370160B93501C92E4C6BE0A5C4993601A5 

C599370160A5C2993601A5C399370160A000A5D7 91D5A5D8C891D560BD3501C8 91 

D5E860A002B1DDC92EF004C921D00920D7B420D7B420D7B420A4B3608E1E01C050 

90042043B4 6086D18 6D28E1A014CE5E0B93501C92BF007C92DF01EC92060C8201A 

E1B003EE1A0118AD180165D185D1AD190165D285D24CD6EOC8201AE1B003EE1A01 

38A5D1ED180185D1A5D2ED190185D24CD6E020CAB486C084E18E18018E1901B935 

01C925D01BC8B93501C930F006C931F005386018 9001382E18012E19014C2EE120 

9AE1B006B935014CA8E1C8B93501209AE1B0F7984888B9350184CE209AE19020F0 

17A8BD90E1186D18018D1801BD95E16D19018D190188D0EAA4CEE8E005D0D568A8 

A20038 60010A64E8100000000327C9309004C93A900218 60290F38 60C924F04AC9 

3DF039A6E1A002B1DDC92FD001C8B1DDF0034CBDE2A200A4E1C8B935012054E290 

F7C921F004C92ED008A5BDD0EBA5BCD0E7AD1301F0032045B41860A5D78D1801A5 

D88D1901C83860A218C82042B6A5E0D0482040B41860B1DD08297FDD3501D011E8 

C82810F18AA8B935012054E2B00B900128A20020A8E0B85087 98AAA000B1DD8D18 

01C8B1DD8D1901C8B1DDC92FF003EE1E018AA8A200E6C0386020C1E0D001 602043 

B4 60C92E9008C93DF004C97B900138 60A009201EB520CAB4 8 6CF20CAE3A002B1DD 

D00420CAE36020B2B3AD3501C921F004C92ED00620A8E04C6FE2981865CF85CF20 

A8B5A93D20A4E32035B620A8E0A4CFA4CF20DCE3C884CFC012F0C0C024F0BCB0B5 

D0EC8E11014C5EB2B1DDC92ED01BA5BCF03EC8B1DDC5C2D037C8B1DDC5C3D030BD 

3501C92ED029F02AC921D014C8B1DDC5C4D01CC8B1DDC5C5D015A5BDF014D015A5 

BDD00BBD3501C92EF004C921D0074C21E2E8E8E8C84C05E2AD0CA029DF8D0CA060 

ADOOA009808DOOA060ADOCA009208DOCA060ADOOA0297F8DOOA060A20820E6B2AD 

0801D006200FE34C60B0C901F0034C37B42018E34C60B0A20820E6B2AD0801D006 

2021E34C60B0C901D0E3202AE34C60B0206DE32070E32073E3A2608E2D018E2E01 

EE2D01D0FBEE2E01D0F6A20060202AE32073E3602021E3206AE3602073E32018E3 

602073E3200FE3604884E48 6E5AD1F01F005684820B4E86820AFEBA4E4A6E5D8 60 
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